ThemeProvider

Theme context for light, dark, and high-contrast modes.

Status: beta. Group: utility. Markdown version: /design-system/components/theme-provider.md

When to use

Context provider owning the light/dark/high-contrast theme state, class application, and persistence. Mounted once by the app shell.

The contract records no forbidden uses.

The contract names no look-alike with a deciding condition.

ThemeProvider props
Prop	Type	Default	Description	Required
`children`	`React.ReactNode`	none	Subtree that receives the theme context.	Yes
`forcedTheme`	`"light" \| "dark" \| "hcb" \| "hcw"`	none	Pin the theme regardless of stored/system preference (e.g. external embeds).	No

The contract records no invalid combinations.

The contract records no keyboard interaction.

Every item under When not to use is a MUST NOT. MUST and SHOULD follow RFC 2119.

ThemeProvider rules
Level	Rule	How it is checked
MUST	Required stories produce no axe violations at the configured severity.	Automated by `npm run test:stories:matrix:ci`. WCAG 2.5.8.
MUST	The accessibility tree (role, name, state) matches the committed snapshot for every required story.	Automated by `npm run test:stories:matrix:ci`. WCAG 1.3.1, 4.1.2.
MUST	The component remains legible and operable under a real browser forced-colors: active pass.	Automated by `npm run test:stories:hc`.
MUST	A human completed an end-to-end accessibility review of this component.	Manual review, last on 2026-05-28.
MUST NOT	Maintainers: Do not bypass design tokens or skip forced-colors verification at beta.	Release review; not machine-checked.

Install: npm install @digitaltableteur/react (version 0.9.1, restricted access on npm).
Import: import { ThemeProvider } from "@digitaltableteur/react";
Entry point: @digitaltableteur/react/runtime exports it too.
Styles: import @digitaltableteur/react/style.css once at the app boundary.