Struct ThemeProvider 

pub struct ThemeProvider { /* private fields */ }

Holds the active theme, any registered custom themes, and the opt-in “follow the OS appearance” mode.

The reduced-motion preference is deliberately not a field here. GPUI owns that flag (App::reduce_motion) and its own Animation/spring elements read it directly, so a copy on this global would be a second source of truth: a consumer app writing a plain gpui::Animation, or any GPUI internal such as animated-image playback, would keep animating after HeroGPUI was told to stop. ActiveTheme::reduce_motion therefore reads GPUI’s flag and set_reduce_motion writes it, so the two cannot disagree.

Implementations

impl ThemeProvider

pub fn init(cx: &mut App)

Registers the provider with the default light theme.

Call this once before opening the first window. Rendering a themed component before initialization panics.

pub fn init_with(theme: Theme, cx: &mut App)

Registers the provider starting from an explicit theme.

Call this once before opening the first window. Rendering a themed component before initialization panics.

The reduced-motion preference is left as it is: GPUI does not surface the OS prefers-reduced-motion setting and this crate reads no environment variable, so an application that offers the preference sets it explicitly with set_reduce_motion (before or after this call) from its own settings.

pub fn get(cx: &App) -> &Self

Returns the global provider. Panics if init has not registered it.

pub fn theme(&self) -> &Theme

The active theme.

pub fn contains(&self, id: &str) -> bool

Whether a theme with this id has been registered.

pub fn active_id(&self) -> &SharedString

The id of the active theme.

pub fn register(&mut self, theme: Theme)

Registers and activates a custom theme.

pub fn insert(&mut self, theme: Theme)

Registers a theme without activating it, replacing any theme with the same id. The active theme is unchanged (re-inserting the active id swaps its tokens in place).

pub fn theme_ids(&self) -> Vec<SharedString>

The ids of every registered theme, sorted.

pub fn set_active( &mut self, id: impl Into<SharedString>, ) -> Result<(), UnknownThemeError>

Activates a previously registered theme by id.

An id that was never registered is refused: the active theme stays as it was and the error carries the rejected id.

pub fn follows_system_appearance(&self) -> bool

Whether the OS light/dark appearance is being followed — the state a three-way “Light / Dark / System” setting needs to render itself.

Trait Implementations

impl Global for ThemeProvider