ThemeOverride

A utility widget that rebuilds the Material Theme for a subtree using AppTheme.light or AppTheme.dark — the sanctioned way to locally flip brightness (dark chrome over imagery, a dark-locked sheet). Source: theme_override.dart.

ThemeOverride(
  brightness: Brightness.dark,
  child: ...,
)

Props

Prop	Type	Default	Notes
`brightness`	`Brightness`	required	Theme for the subtree
`child`	`Widget`	required

The accentPalette parameter was removed with the persona system in Sundial 2.0 — brightness is the only axis. See Accent Theming.

Behavior

The override installs a complete theme — ThemeExtensions, Material component themes, ColorScheme, TextTheme — not a partial patch. And since all Sundial tokens implement lerp, entering/changing an override animates via AnimatedTheme when it replaces an existing theme in place. The canonical use is textured or dark surfaces whose content must read light regardless of the app theme: StyledListTile wraps its content in ThemeOverride(brightness: Brightness.dark) over textured wallpapers, and the feature-intro and force-update modals lock their chrome the same way.

Getting Started

Craft and Foundations

Brand

Design System

For Agents

Props

Behavior