Academic Pages ships with six built-in visual themes, each available in both a light and a dark variant. The active theme is set by a single line inDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/academicpages/academicpages.github.io/llms.txt
Use this file to discover all available pages before exploring further.
_config.yml. Theme stylesheets live in _sass/theme/ and are imported automatically by assets/css/main.scss based on the value of site_theme. Preview images for all themes are stored in images/themes/.
Setting the Theme
Open_config.yml and update the site_theme field near the top of the file:
_config.yml
Edit _config.yml
Replace the value of
site_theme with your chosen theme name. The value is case-sensitive and must be lowercase.Restart Jekyll
Stop and restart your local server (
jekyll serve). Because _config.yml is not hot-reloaded, changes only take effect after a full restart.The theme name in
site_theme is appended with _light and _dark by assets/css/main.scss to import the correct SCSS partials. Setting site_theme: "default" loads _default_light.scss and _default_dark.scss; setting site_theme: "air" loads _air_light.scss and _air_dark.scss, and so on.Available Themes
Default
The default theme uses a clean, neutral palette centered on blue-gray tones. It is the most conservative choice and closely resembles the upstream Minimal Mistakes theme from which Academic Pages was forked.- Light
- Dark
- Background:
#ffffff(white) - Primary accent:
#2f7f93(muted teal-blue) - Text: dark gray (
mix(#000, #7a8288, 40%)) - Links:
#52adc8(sky blue), visited links lighten toward the accent color - Footer background:
#f2f3f3(near-white gray) - Code background:
#fafafa
images/themes/homepage-light.png_config.yml
Air
The Air theme has a light, airy feel with a sky-blue primary color and a light gray background. The dark variant shifts to deep charcoal with a teal accent, evoking a calm, modern aesthetic.- Light
- Dark
- Background:
#eeeeee(light gray) - Primary accent:
#0092ca(sky blue) - Text:
#222831(near-black) - Links:
#393e46(dark slate), hovering darkens the link - Footer background: matches the primary accent color (
#0092ca) - Code background:
#fafafa
images/themes/homepage-air-light.png_config.yml
Sunrise
The Sunrise theme draws on warm amber and coral tones. The light variant uses a warm parchment background; the dark variant evokes a deep night sky with warm ember highlights.- Light
- Dark
- Background:
#e8d5b7(warm parchment/tan) - Primary accent:
#fc3a52(coral red) - Text:
#000000(black) - Links: near the primary coral color, darkened slightly
- Footer background:
#f9b248(amber/golden)
images/themes/homepage-sunrise-light.png_config.yml
Mint
The Mint theme uses a fresh teal-green palette. The light variant is clean and cool; the dark variant is a deep forest green with luminous mint highlights.- Light
- Dark
- Background:
#f3f6f6(very light blue-gray) - Primary accent:
#11999e(teal) - Text:
#40514e(dark teal-gray) - Links: teal (
#11999e) - Footer background:
#30e3ca(bright mint)
images/themes/homepage-mint-light.png_config.yml
Dirt
The Dirt theme uses earthy, organic browns and tans. The light variant is understated and warm; the dark variant creates a cozy, wood-fire atmosphere.- Light
- Dark
- Background:
#f3f3f3(near-white warm gray) - Primary accent:
#343434(dark charcoal) - Text:
#343434(dark charcoal) - Links:
#343434(charcoal) - Footer background:
#e9dcbe(light tan/wheat) - Border color:
#e9dcbe(tan)
images/themes/homepage-dirt-light.png_config.yml
Contrast
The Contrast theme is designed for maximum legibility and accessibility. The light variant is stark black-on-white; the dark variant uses a pure black background with high-contrast colored links.- Light
- Dark
- Background:
#ffffff(pure white) - Primary accent:
#b60000(deep red) - Text:
#000000(pure black) - Links:
#0000ff(pure blue), hover darkens to#0000cc - Footer background:
#ffffff(white) - Selection background:
#b3d4fc
images/themes/homepage-contrast-light.png_config.yml
Theme Summary
default
Neutral blue-gray palette. Clean and professional. Closest to the upstream Minimal Mistakes theme.
air
Sky blue and light gray in light mode; dark charcoal with teal in dark mode. Modern and calm.
sunrise
Warm parchment and coral in light mode; deep brown-black with ember tones in dark mode.
mint
Fresh teal-green in both modes. Clean light variant; vivid dark forest-green variant.
dirt
Earthy browns and tans. Understated in light mode; cozy and warm in dark mode.
contrast
Maximum legibility. Pure black/white in light mode; pure black with vivid color accents in dark mode.
Light and Dark Mode Switching
Academic Pages does not provide a manual light/dark toggle — the active variant is determined entirely by the visitor’s operating system or browser preference via the CSSprefers-color-scheme media query. Both the _light and _dark SCSS files for your chosen theme are always compiled into assets/css/main.css; the browser selects the appropriate set of CSS custom properties at render time.