Skip to main content
UDSUrban Design SystemBuild a multi-component HTML demoSITE 2026.06.10.1
Color
Brand
Font
Scale
Density

Semantic Colors

Role-based color tokens that adapt across themes, brands, and light/dark modes. Use these instead of primitives in component and layout code.

Interactive surfaces

Primary action colors that change per brand. Tokens marked * shift when switching brands.

--uds-color-surface-interactive-nonetransparent
--uds-color-surface-interactive-neutralneutral bg
--uds-color-surface-interactive-defaultprimary action bg *
--uds-color-surface-interactive-hoverhover *
--uds-color-surface-interactive-activepressed *
--uds-color-surface-interactive-subtleghost bg *
--uds-color-surface-interactive-subtle-hoverghost hover *
--uds-color-surface-interactive-subtle-activeghost pressed *
--uds-color-surface-interactive-disabled
--uds-color-surface-interactive-reddanger action bg
--uds-color-surface-interactive-red-hoverdanger hover
--uds-color-surface-interactive-red-activedanger pressed
--uds-color-surface-interactive-red-subtledanger ghost bg
--uds-color-surface-interactive-red-subtle-hoverdanger ghost hover
--uds-color-surface-interactive-red-subtle-activedanger ghost pressed

Status surfaces

--uds-color-surface-info
--uds-color-surface-info-subtle
--uds-color-surface-error
--uds-color-surface-error-subtle
--uds-color-surface-warning
--uds-color-surface-warning-subtle
--uds-color-surface-success
--uds-color-surface-success-subtle

Page surfaces

--uds-color-surface-page-main
--uds-color-surface-page-subtle
--uds-color-surface-page-alt
--uds-color-surface-page-bold
--uds-color-surface-page-inverse

Component surfaces (neutral scale)

--uds-color-surface-nonetransparent
--uds-color-surface-main
--uds-color-surface-subtle
--uds-color-surface-alt
--uds-color-surface-bold
--uds-color-surface-xbold
--uds-color-surface-xxbold
--uds-color-surface-inverse
--uds-color-surface-white
--uds-color-surface-black

Text

--uds-color-text-brandchanges per brand *
--uds-color-text-primary
--uds-color-text-inverse
--uds-color-text-secondary
--uds-color-text-disabled
--uds-color-text-disabled-bold
--uds-color-text-interactive
--uds-color-text-interactive-hover
--uds-color-text-interactive-active
--uds-color-text-interactive-neutral
--uds-color-text-info
--uds-color-text-success
--uds-color-text-error
--uds-color-text-warning

Border

--uds-color-border-nonetransparent
--uds-color-border-brandchanges per brand *
--uds-color-border-primary
--uds-color-border-secondary
--uds-color-border-tertiary
--uds-color-border-inverse
--uds-color-border-disabled
--uds-color-border-interactive*
--uds-color-border-interactive-hover*
--uds-color-border-interactive-active*
--uds-color-border-subtle-interactive*
--uds-color-border-subtle-interactive-hover*
--uds-color-border-subtle-interactive-active*
--uds-color-border-info
--uds-color-border-success
--uds-color-border-error
--uds-color-border-warning

Outline (focus / interaction rings)

--uds-color-border-outline-hover
--uds-color-border-outline-active
--uds-color-border-outline-focus-visible

Brand surfaces

Brand colors for logos and brand marks. Static tokens stay the same across all modes.

--uds-color-surface-brand-dynamic-boldactive brand accent *
--uds-color-surface-brand-resman-bold
--uds-color-surface-brand-resman-static
--uds-color-surface-brand-anyonehome-bold
--uds-color-surface-brand-anyonehome-static
--uds-color-surface-brand-inhabit-bold
--uds-color-surface-brand-inhabit-static

Icon

--uds-color-icon-nonetransparent
--uds-color-icon-brandchanges per brand *
--uds-color-icon-primary
--uds-color-icon-inverse
--uds-color-icon-secondary
--uds-color-icon-disabled
--uds-color-icon-disabled-bold
--uds-color-icon-interactive*
--uds-color-icon-interactive-hover*
--uds-color-icon-interactive-active*
--uds-color-icon-info
--uds-color-icon-success
--uds-color-icon-error
--uds-color-icon-warning