Vitepress Theme Akari Docsv1.0.0GitHubSettingsMore

Settings and appearance ​

Readers can adjust how pages look. The round appearance button at the bottom of the rail (at the bottom of the navigation drawer on narrow screens) switches between light and dark mode, and the gear button in the app bar opens the settings. These options apply only to the reader's own browser. They are saved in localStorage and do not affect other visitors.

Light and dark mode ​

Each press of the button switches to the next mode, and a snackbar appears at the bottom of the screen, for example "Theme switched to: Dark".

ModeIconEffect
Systembrightness_autoFollows the system's light or dark setting (default)
Lightlight_modeAlways light
Darkdark_modeAlways dark
Time of dayscheduleDark from 19:00 to 07:00 the next day, light the rest of the time

In System and Time of day modes, the snackbar also says whether the page is currently light or dark, for example "Theme switched to: System (Dark)".

Settings ​

The settings dialog that the gear button opens has six groups of options. Changes take effect immediately:

OptionContent
ColorThe theme's seed color
VariantHow the palette is generated from the seed color, for example Tonal Spot or Vibrant
ContrastDefault, Medium, High
MotionStandard, Expressive
Text directionFollow language, Left to right, Right to left
Text size100%, 150%, 200%
VariantTonal SpotVibrantExpressiveMonochrome
PersistenceSave in this browser

These controls are only a visual demo. Changing them does not change the theme.

Pages with a hero use a color taken from the image instead. When you leave the page, the color from the settings comes back.

The site's default appearance ​

A reader's choices are saved only in their own browser. To change what everyone sees on their first visit, set defaults in the shared config:

ts
// docs/config.ts
settings: {
  defaults: {
    color: "#6750A4",
    scheme: "auto",
    motion: "expressive",
  },
},

You can also show only some of the options, or hide the appearance button. See API. For how light and dark mode takes effect before the first frame, and where each option applies, see Details.

GitHub Settings

Search the docs

Type a page title, a component name or words from the text.

Press ⌘/Ctrl + K to open it anytime

Choose a language

EnglishEnglish (United States)العربيةArabic (Saudi Arabia)FrançaisFrench (France)日本語Japanese (Japan)한국어Korean (South Korea)简体中文Chinese (China)

Settings

Color
VariantTonal SpotVibrantFidelityExpressiveMonochromeNeutralRainbowFruit Salad
ContrastDefaultMediumHigh
MotionStandardExpressive
Text directionFollow languageLeft to rightRight to left
Text size100%150%200%