Light theme by default

[alexgleason]

Hello, I'm having trouble making Vitepress use the light theme by default, but still allow the user to change the theme.

Here is what I want:

• Device preferences are ignored
• The theme is light by default
• The user can toggle dark mode

Is this possible?

[brc-dd]

try this

import { defineConfig } from 'vitepress'

export default defineConfig({
  appearance: {
    // @ts-expect-error not fully supported yet
    initialValue: 'light'
  }
})

[alexgleason]

This works, thank you!

[brc-dd]

Let us know if you encounter any problem with that. If there isn't any weird edge case we can add it to types.

[alexgleason]

I only confused myself at first because the toggle value was already set in localStorage. After clearing that, it works as expected.

[brc-dd]

Ah, yeah that's expected. For new users (you can try in incognito maybe) it should be light regardless of their device preference.