Overview

Theming

Control the light/dark mode experience for your readers.


Theming Options#

Setting What it does
Theme toggle Show or hide the light/dark mode switcher
Default theme What visitors see on their first visit: light or dark

How to configure:

Float Widget → DesignTheme tab → adjust settings → Save.

Tips for choosing defaults:

  • Technical or developer-focused docs → dark default is widely preferred.
  • User-facing or marketing-style docs → light default feels more approachable.
  • When in doubt, keep the toggle visible so readers can choose their own preference.

Theme Settings#

Default Theme#

Sets what a new visitor sees before they've made any choice.

Options: Light | Dark

The visitor's preference is saved in their browser — so returning visitors always see their last-used theme, regardless of your default.

Theme Toggle Visibility#

When enabled, a sun/moon icon appears in the header or sidebar for visitors to switch themes manually.

You can also control where the toggle appears:


Build docs your readers enjoy using. Connect your GitHub repo →