Struct Theme 

pub struct Theme {

    pub colors: ThemeColor,
    pub tokens: ThemeTokens,
    pub highlight_theme: Arc<HighlightTheme>,
    pub light_theme: Rc<ThemeConfig>,
    pub dark_theme: Rc<ThemeConfig>,
    pub mode: ThemeMode,
    pub font_family: SharedString,
    pub font_size: Pixels,
    pub mono_font_family: SharedString,
    pub mono_font_size: Pixels,
    pub radius: Pixels,
    pub radius_lg: Pixels,
    pub shadow: bool,
    pub focus_ring: bool,
    pub transparent: Hsla,
    pub scrollbar_mode: ScrollbarMode,
    pub notification: NotificationSettings,
    pub tile_grid_size: Pixels,
    pub tile_shadow: bool,
    pub tile_radius: Pixels,
    pub list: ListSettings,
    pub sheet: SheetSettings,
    pub motion: MotionTokens,
}

The global theme configuration.

Fields

colors: ThemeColor

tokens: ThemeTokens

Component-specific resolved tokens retained for legacy compatibility.

New application-owned presentation should use Self::semantic_tokens rather than extending this legacy surface.

highlight_theme: Arc<HighlightTheme>

light_theme: Rc<ThemeConfig>

dark_theme: Rc<ThemeConfig>

mode: ThemeMode

font_family: SharedString

The font family for the application, default is .SystemUIFont.

font_size: Pixels

The base font size for the application, default is 16px.

mono_font_family: SharedString

The monospace font family for the application.

Defaults to:

• macOS: Menlo
• Windows: Consolas
• Linux: DejaVu Sans Mono

mono_font_size: Pixels

The monospace font size for the application, default is 13px.

radius: Pixels

Radius for the general elements.

radius_lg: Pixels

Radius for the large elements, e.g.: Dialog, Notification border radius.

shadow: bool

focus_ring: bool

Whether focused controls draw a ring outside their border, default true.

The ring is painted outside the element, so any ancestor that clips its content will cut it off. An application whose layout clips heavily can turn it off here: focused controls then show only their tinted border, which costs no space and cannot be clipped.

transparent: Hsla

scrollbar_mode: ScrollbarMode

Show the scrollbar mode, default: Scrolling

notification: NotificationSettings

The notification setting.

tile_grid_size: Pixels

Tile grid size, default is 4px.

tile_shadow: bool

The shadow of the tile panel.

tile_radius: Pixels

The border radius of the tile panel, default is 0px.

list: ListSettings

The list settings.

sheet: SheetSettings

The sheet settings.

motion: MotionTokens

Semantic motion policy for styled components.

Implementations

impl Theme

pub fn apply_config(&mut self, config: &Rc<ThemeConfig>)

Apply the given theme configuration to the current theme.

impl Theme

pub fn global(cx: &App) -> &Theme

Returns the global theme reference

pub fn global_mut(cx: &mut App) -> &mut Theme

Returns the global theme mutable reference

Changes to fields the Base layer mirrors — the radius, the colors, the fonts — reach the scrollbar and resize handles only once Theme::sync_base runs.

pub fn is_dark(&self) -> bool

Returns true if the theme is dark.

pub fn theme_name(&self) -> &SharedString

Returns the current theme name.

pub fn sync_system_appearance(window: Option<&mut Window>, cx: &mut App)

Sync the theme with the system appearance

pub fn sync_scrollbar_appearance(cx: &mut App)

Sync the Scrollbar showing behavior with the system

pub fn set_scrollbar_mode(mode: ScrollbarMode, cx: &mut App)

Changes the scrollbar display mode and synchronizes the Base projection.

pub fn change( mode: impl Into<ThemeMode>, window: Option<&mut Window>, cx: &mut App, )

Change the theme mode.

pub fn sync_base(cx: &mut App)

Push the current theme down to the Base layer.

The Base layer holds its own copy of the theme — the semantic tokens plus the scrollbar and resize-handle styles — because it paints those without going through gpui-component. Theme::change refreshes that copy, but writing to the theme’s public fields directly does not, so a scrollbar keeps painting with the radius and colors it was last given.

Call this after mutating the theme through Theme::global_mut:

Theme::global_mut(cx).radius = px(0.);
Theme::sync_base(cx);

It rebuilds the Base theme from scratch, so any style written straight onto the Base global is replaced — the same thing Theme::change does.

pub fn input_background(&self) -> Hsla

Get the input background color.

For dark, use a transparent color mixed with the input border: cx.theme().input, otherwise use the cx.theme().background color.

pub fn semantic_tokens(&self) -> SemanticThemeTokens

Returns a snapshot of the semantic design tokens represented by this theme. The snapshot is computed from the legacy public fields so direct mutations of those fields are reflected immediately.

pub fn motion_tokens(&self) -> &MotionTokens

Returns the styled layer’s semantic motion policy.

pub fn color_tokens(&self) -> ColorTokens

pub fn radius_full(&self) -> Pixels

The radius of a shape that reads as a circle or a pill — an avatar, a slider thumb, a badge dot, a pill tab.

A theme whose Theme::radius is zero squares these off too, so one setting governs the whole UI instead of leaving a handful of permanently round elements behind. Use it in place of gpui::Styled::rounded_full, or reach for crate::ThemeStyled::rounded_full_style when styling an element.

pub fn radius_2xl(&self) -> Pixels

Returns the next surface radius above the existing xl theme tier.

Larger surface tiers derive from the same application-controlled base radius, so adjusting or squaring the theme updates every tier together.

pub fn radius_3xl(&self) -> Pixels

Returns the surface radius above Self::radius_2xl.

pub fn radius_4xl(&self) -> Pixels

Returns the surface radius above Self::radius_3xl.

pub fn radius_tokens(&self) -> RadiusTokens

pub fn spacing_tokens(&self) -> SpacingTokens

pub fn typography_tokens(&self) -> TypographyTokens

pub fn shadow_tokens(&self) -> ShadowTokens

pub fn apply_semantic_tokens(&mut self, tokens: &SemanticThemeTokens)

Applies the subset of semantic tokens representable by the legacy theme. Scale-only spacing and elevation details have no legacy storage; legacy components therefore keep their existing behavior.

pub fn resolve_semantic_config( &self, config: &SemanticThemeConfig, ) -> SemanticThemeTokens

Resolves a standalone semantic configuration over the current legacy theme without mutating either value.

pub fn apply_semantic_config( &mut self, config: &SemanticThemeConfig, ) -> SemanticThemeTokens

Applies the legacy-representable part of a standalone semantic config and returns the complete resolved snapshot for application-owned UI.

pub fn apply_semantic_config_str( &mut self, content: &str, ) -> Result<SemanticThemeTokens>

Parses and applies a standalone { "tokens": ... } semantic theme file.

Trait Implementations

impl Clone for Theme

fn clone(&self) -> Theme

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Theme

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Theme

fn default() -> Self

Returns the “default value” for a type.

impl Deref for Theme

type Target = ThemeColor

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for Theme

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<'de> Deserialize<'de> for Theme

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&ThemeColor> for Theme

fn from(colors: &ThemeColor) -> Self

Converts to this type from the input type.

impl Global for Theme

impl JsonSchema for Theme

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for Theme

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.