Dark Mode

Every color scheme of Break has a light and a dark version. You choose which one a visitor sees first. Readers can then switch for themselves in the settings panel or with the d key, unless you turn that off.

Setup Instructions#

1. Go to ⛭ Settings → Design
2. Click Customize
3. Open the Theme tab
4. Find the Dark mode setting
5. Choose an option
6. Click Save

Available Options#

Readers Switching for Themselves#

Out of the box, readers can switch between light and dark in two ways:

• the Appearance row of the settings panel, opened from the gear icon in the top bar
• the d key

The Dark mode setting then decides only what a visitor sees on the first visit. Once a reader switches, their choice is kept in their own browser and applies to every page and every later visit. See Reading Preferences.

Turning the Switch Off#

To fix the site to your setting, add toggle-dark-mode to Disabled features.

1. Go to ⛭ Settings → Design
2. Click Customize
3. Open the Theme tab
4. Add toggle-dark-mode to Disabled features, separated from the other values by a comma
5. Click Save

With toggle-dark-mode listed, the Appearance row disappears from the settings panel. See Features.

Notes#

• Ghost's comments follow the scheme of the page, light or dark.
• A visitor who has not switched yet follows a change of their system setting while the page is open, even when Dark mode is Light or Dark. After a reload they see your setting again.
• Each color scheme has its own dark version. Contrast uses a true black background. See Color Scheme.
• For a logo that reads well on a dark background, see Logo.