Skip to content

Clarify that theme does not set a default dark/light color mode - #6834

Draft
fern-api[bot] wants to merge 3 commits into
mainfrom
2026-09-02-fern-ai-2fbdc2-df840d60
Draft

Clarify that theme does not set a default dark/light color mode#6834
fern-api[bot] wants to merge 3 commits into
mainfrom
2026-09-02-fern-ai-2fbdc2-df840d60

Conversation

@fern-api

@fern-api fern-api Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Added a Note callout to the "Theme configuration" section of the site-level settings page explaining that theme: styles UI elements only and does not control the color mode; Fern follows the visitor's OS preference and no docs.yml key forces dark or light mode. The Note lists the closest options with links: settings.dark-mode-code: true (Settings configuration), <Fern.ThemeSwitch /> in a custom header (Header and footer page), and setting both light and dark values under colors.

Co-Authored-By: bot_apk <apk@cognition.ai>
Customize the visual style of specific UI elements across your documentation site.

<Note title="Setting a default color mode">
The `theme` key styles UI elements (sidebar, body, tabs). It does not control the light/dark color mode. Fern follows the visitor's operating system preference, and no `docs.yml` key forces the site into dark or light mode for all visitors. The closest options are:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] <Microsoft.Contractions> reported by reviewdog 🐶
Use 'doesn't' instead of 'does not'.

Suggested change
The `theme` key styles UI elements (sidebar, body, tabs). It does not control the light/dark color mode. Fern follows the visitor's operating system preference, and no `docs.yml` key forces the site into dark or light mode for all visitors. The closest options are:
The `theme` key styles UI elements (sidebar, body, tabs). It doesn't control the light/dark color mode. Fern follows the visitor's operating system preference, and no `docs.yml` key forces the site into dark or light mode for all visitors. The closest options are:

Co-Authored-By: bot_apk <apk@cognition.ai>
@github-actions

github-actions Bot commented Sep 2, 2026

Copy link
Copy Markdown
Contributor

Co-Authored-By: bot_apk <apk@cognition.ai>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants