Add config option to hide theme switch

[oksiweb]

Changes

• Added a new header.themeSwitcher.enabled config option.
• When header.themeSwitcher.enabled is set to false, the light/dark theme switch is hidden from both the desktop header and the mobile navigation drawer.
• The option defaults to true, so existing sites keep the current behavior.
• Added documentation and test coverage for the new config option.

How to test

Set the option in zudoku.config.tsx:

header: {
  themeSwitcher: {
    enabled: false,
  },
}

Then run:

pnpm nx run zudoku:typecheck
pnpm nx run cosmo-cargo:build

You can also run the example locally:

nx run cosmo-cargo:dev

Expected successful behavior

• When header.themeSwitcher.enabled is unset or true, the theme switch remains visible in the desktop header and mobile navigation drawer.
• When header.themeSwitcher.enabled is false, the theme switch is not rendered in the desktop header.
• When header.themeSwitcher.enabled is false, the theme switch is not rendered in the mobile navigation drawer.
• Other header placement options, such as navigation, search, and auth, continue to work as before.

Unexpected behavior

• The theme switch is hidden by default when header.themeSwitcher.enabled is not configured.
• The theme switch is still rendered in the desktop header when header.themeSwitcher.enabled is false.
• The theme switch is still rendered in the mobile navigation drawer when header.themeSwitcher.enabled is false.
• Existing header navigation, search, or auth placement behavior changes unexpectedly.

[vercel]

Someone is attempting to deploy a commit to the Zuplo Team on Vercel.

A member of the Team first needs to authorize it.

[github-actions]

Preview build of published Zudoku package

Warning

This PR is from an external contributor. To run the public package build workflow, a maintainer must add the approve public build label after reviewing the changes.

[Copilot]

Pull request overview

Adds a new header.showThemeSwitch configuration option to let consumers hide the light/dark theme toggle while preserving existing default behavior (visible unless explicitly disabled).

Changes:

• Extend config/types to include header.showThemeSwitch?: boolean.
• Conditionally render ThemeSwitch in both the desktop header and mobile navigation drawer based on the new flag.
• Document the new configuration option.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
packages/zudoku/src/lib/core/ZudokuContext.ts	Adds showThemeSwitch to the in-app header options type.
packages/zudoku/src/lib/components/MobileTopNavigation.tsx	Hides the theme switch in the mobile drawer when configured.
packages/zudoku/src/lib/components/Header.tsx	Hides the theme switch in the desktop header when configured.
packages/zudoku/src/config/validators/ZudokuConfig.ts	Adds schema/type support for header.showThemeSwitch.
packages/zudoku/src/app/main.tsx	Passes showThemeSwitch from validated config into runtime options.
docs/pages/docs/configuration/overview.md	Documents the new header.showThemeSwitch option and its default.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[mosch]

Hey @oksiweb - congrats on your first PR - looking good!

Can we just rename this to themeSwitcher: { enabled: true } (default true)` than we are good to go. This allows us to add more options later.

[oksiweb]

Hey @oksiweb - congrats on your first PR - looking good!

Can we just rename this to themeSwitcher: { enabled: true } (default true)` than we are good to go. This allows us to add more options later.

fixed

[dan-lee]

Avoid the nested-spread default injection. Default at the consumer instead (see suggestions on Header.tsx and MobileTopNavigation.tsx).

Suggested change

	this.options = {
	...options,
	header: {
	...options.header,
	themeSwitcher: {
	...options.header?.themeSwitcher,
	enabled: options.header?.themeSwitcher?.enabled ?? true,
	},
	},
	};
	this.options = options;

[oksiweb]

@dan-lee Fixed

[Copilot]

Pull request overview

Copilot reviewed 9 out of 9 changed files in this pull request and generated 4 comments.

[Copilot]

Pull request overview

Copilot reviewed 9 out of 9 changed files in this pull request and generated 1 comment.

[Copilot]

Pull request overview

Copilot reviewed 9 out of 9 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 9 out of 9 changed files in this pull request and generated no new comments.

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
zudoku-cosmo-cargo	Ready	Preview, Comment	May 12, 2026 7:02am
zudoku-dev	Ready	Preview, Comment	May 12, 2026 7:02am

[dan-lee]

Thanks for your contribution and the quick turnaround @oksiweb! I also dropped the duplicate ?? true default in main.tsx so the fallback now lives only in the two consumers