Color
Rosetta Stone: Surfaces, Colors, Borders & Elevation
Standard’s OKLCH relative color engine derives a complete light/dark surface ladder and 10-hue spectrum from just two theme seeds (--color-light-background and --color-light-foreground). Never read --color-light-* or --color-dark-* in components; always use the semantic role tokens or utility classes below.
1. Surface Ladder & Text Roles
| Intention | HTML Utility Class | CSS Token (var(...)) |
|---|---|---|
| Outer stage / bezel | .bg-stage |
var(--color-stage) |
| Recessed well / code / input | .bg-surface-sunken |
var(--color-surface-sunken) |
| Root page background | .bg-background |
var(--color-background) |
| Card / panel surface | .bg-surface |
var(--color-surface) |
| Elevated card / hover surface | .bg-surface-raised |
var(--color-surface-raised) |
| Modal / popover / floating UI | .bg-surface-overlay |
var(--color-surface-overlay) |
| Translucent frosted glass | .bg-glass |
var(--color-glass) + var(--filter-glass) |
| Primary body ink | .text-primary |
var(--color-foreground) |
| Secondary / metadata text | .text-muted |
var(--color-muted) |
| Tertiary / de-emphasized text | .text-subtle |
var(--color-subtle) |
| Brand / interactive accent | .text-accent / .bg-accent |
var(--color-accent) |
| Status feedback | .success, .warning, .error, .info |
var(--color-success), -warning, -error, -info |
2. Borders, Radius & Shadows
| Intention | HTML Utility Class | CSS Token (var(...)) |
|---|---|---|
| Standard hairline border | .border, .border-t, .border-b, .border-l, .border-r |
var(--border) (1px solid var(--color-border)) |
| Accent border | .border-accent |
var(--border-accent) |
| Corner radius ladder | .rounded-sm, .rounded, .rounded-lg, .rounded-xl |
var(--radius-sm), var(--radius), calc(var(--radius) * 1.5) |
| Pill / Avatar circle | .rounded-full (9999px), .rounded-50 (50%) |
— |
| Elevation shadows | .shadow-xs, .shadow-sm, .shadow-md, .shadow-lg, .shadow-xl |
var(--shadow-xs) .. var(--shadow-xl) |
| Special shadows | .shadow-raised, .shadow-inset, .shadow-ring, .shadow-glow |
var(--shadow-raised), -inset, -ring, -glow |
Color System
Foundation
Seed-first OKLCH color engine. Set one thing — your light foreground color — and a full light/dark palette, ten semantic hues, and a shadow/elevation scale all derive from it via oklch(from <seed> ...) relative color syntax. Override at three depths: set --color-light-foreground alone (everything else follows); set individual --color-light-* / --color-dark-* tokens for per-scheme control; or theme fully via [data-theme] selectors, which re-resolve the whole token set at any element, not just :root.
| Name | Description | Value |
|---|---|---|
--color-light-foreground |
The primary light foreground seed. Change this alone and dark mode, all ten chromatic hues, and derived surfaces/borders/shadows follow. | |
--color-light-background |
The root light background seed (#faf8f2). |
|
--color-dark-foreground |
Derived dark reading foreground (default ~85% lightness matching foreground hue). | oklab( from var(--color-light-foreground) 0.85 clamp(-0.028, a, 0.028) clamp(-0.… |
--color-dark-background |
Derived dark background (default ~20% lightness matching foreground hue). | oklab( from var(--color-light-foreground) 0.2 clamp(-0.014, a, 0.014) clamp(-0.0… |
--color-background |
Active scheme background token. | light-dark(var(--color-light-background), var(--color-dark-background)) |
--color-foreground |
Active scheme foreground token. | light-dark(var(--color-light-foreground), var(--color-dark-foreground)) |
--color-accent |
Active accent color token (defaults to triadic +120°). | light-dark(var(--color-light-accent), var(--color-dark-accent)) |
--color-border |
Active border color token. | light-dark( var(--color-light-border, rgb(from var(--color-light-foreground) r g… |
--color-surface |
Active elevated surface background. | var(--color-surface-raised) |
--color-muted |
Active muted text color (~60% opacity). | light-dark( var(--color-light-muted, rgb(from var(--color-light-foreground) r g … |
--color-subtle |
Active subtle UI text color (~40% opacity). | light-dark( var(--color-light-subtle, rgb(from var(--color-light-foreground) r g… |
--color-link |
Semantic link color token. | light-dark(var(--color-light-link), var(--color-dark-link)) |
--color-italic |
Colour of italic text. | light-dark( var(--color-light-italic, var(--color-foreground)), var(--color-dark… |
--color-bold |
Colour of bold text. | light-dark( var(--color-light-bold, var(--color-foreground)), var(--color-dark-b… |
--color-success |
Semantic success status color (--color-green). |
var(--color-green) |
--color-warning |
Semantic warning status color (--color-orange). |
var(--color-orange) |
--color-error |
Semantic error status color (--color-red). |
var(--color-red) |
--color-info |
Semantic info status color (--color-blue). |
var(--color-blue) |
--color-light |
Polarity alias resolving to the lighter tone of the active scheme. | light-dark(var(--color-light-background), var(--color-dark-foreground)) |
--color-dark |
Polarity alias resolving to the darker tone of the active scheme. | light-dark(var(--color-light-foreground), var(--color-dark-background)) |
--shadow |
Primary ambient shadow preset. | |
.theme-light |
Forces light token set and color scheme on any subtree. | |
.theme-dark |
Forces dark token set and color scheme on any subtree. | |
.inverse |
Flips scheme to whichever mode is not currently active. | |
data-color-mode? |
Attribute forcing "light" or "dark" scheme mode. |
Pinning a scheme on a subtree
<div class="grid-3">
<div class="theme-light" style="padding: var(--space); border-radius: var(--radius); background: var(--color-background); color: var(--color-foreground)">.theme-light</div>
<div class="theme-dark" style="padding: var(--space); border-radius: var(--radius); background: var(--color-background); color: var(--color-foreground)">.theme-dark</div>
<div class="inverse" style="padding: var(--space); border-radius: var(--radius); background: var(--color-background); color: var(--color-foreground)">.inverse: the opposite of here</div>
</div>
Live
Dark Seed Derivation
Foundation
Both dark seeds inherit hue from the light foreground seed. When a theme does not set an accent, one is derived from the foreground hue, a third of the way around the colour wheel (triadic, +120°); set --color-light-accent and --color-dark-accent to use your own. The dark palette is derived from the light one and a theme may override any value. Warm ink begets a warm dark background and a warm soft reading foreground.
| Name | Description | Value |
|---|---|---|
--color-dark-background |
Dark background matching foreground hue at ~20% lightness and muted chroma. | oklab( from var(--color-light-foreground) 0.2 clamp(-0.014, a, 0.014) clamp(-0.0… |
--color-dark-foreground |
Dark foreground matching foreground hue at ~85% lightness for soft reading brightness. | oklab( from var(--color-light-foreground) 0.85 clamp(-0.028, a, 0.028) clamp(-0.… |
Light Palette
Foundation
Full 10-hue chromatic spectrum generated from light foreground seed via inline relative color syntax.
| Name | Description | Value |
|---|---|---|
--color-light-red |
Error / Red (+25° hue offset). | oklch( from var(--color-light-foreground) clamp(0.55, l, 0.65) max(0.16, c) calc… |
--color-light-orange |
Attention / Orange (+55° hue offset). | oklch( from var(--color-light-foreground) clamp(0.64, l, 0.7) max(0.15, c) calc(… |
--color-light-yellow |
Warning / Yellow (+85° hue offset). | oklch( from var(--color-light-foreground) clamp(0.7, l, 0.76) max(0.14, c) calc(… |
--color-light-green |
Success / Green (+145° hue offset). | oklch( from var(--color-light-foreground) clamp(0.56, l, 0.64) max(0.11, c) calc… |
--color-light-cyan |
Info / Cyan (+190° hue offset). | oklch( from var(--color-light-foreground) clamp(0.58, l, 0.66) max(0.09, c) calc… |
--color-light-blue |
Link / Blue (+240° hue offset). | oklch( from var(--color-light-foreground) clamp(0.5, l, 0.6) max(0.12, c) calc((… |
--color-light-magenta |
Magic / Magenta (+300° hue offset). | oklch( from var(--color-light-foreground) clamp(0.55, l, 0.65) max(0.14, c) calc… |
--color-light-purple |
Purple (+270° hue offset). | oklch( from var(--color-light-foreground) clamp(0.52, l, 0.62) max(0.13, c) calc… |
--color-light-pink |
Pink (+350° hue offset). | oklch( from var(--color-light-foreground) clamp(0.62, l, 0.7) max(0.14, c) calc(… |
--color-light-brown |
Brown (the light orange, darker and muted). | oklch( from var(--color-light-orange) calc(l - 0.2) calc(c * 0.55) h ) |
--color-light-accent-triadic |
Triadic accent (+120°). | oklch( from var(--color-light-foreground) 0.54 max(0.17, min(0.2, c * 2)) calc((… |
--color-light-accent-auto |
Default accent strategy (triadic). | var(--color-light-accent-triadic) |
--color-light-accent |
Active light mode accent color. | var(--color-light-accent-auto) |
Dark Palette
Foundation
Full 10-hue chromatic spectrum generated from dark foreground seed for comfortable dark surfaces.
| Name | Description | Value |
|---|---|---|
--color-dark-red |
Dark mode red (+25° hue offset). | oklch( from var(--color-dark-foreground) clamp(0.62, l, 0.7) max(0.16, c) calc((… |
--color-dark-orange |
Dark mode orange (+55° hue offset). | oklch( from var(--color-dark-foreground) clamp(0.68, l, 0.74) max(0.15, c) calc(… |
--color-dark-yellow |
Dark mode yellow (+85° hue offset). | oklch( from var(--color-dark-foreground) clamp(0.75, l, 0.8) max(0.14, c) calc((… |
--color-dark-green |
Dark mode green (+145° hue offset). | oklch( from var(--color-dark-foreground) clamp(0.64, l, 0.72) max(0.11, c) calc(… |
--color-dark-cyan |
Dark mode cyan (+190° hue offset). | oklch( from var(--color-dark-foreground) clamp(0.66, l, 0.74) max(0.09, c) calc(… |
--color-dark-blue |
Dark mode blue (+240° hue offset). | oklch( from var(--color-dark-foreground) clamp(0.62, l, 0.7) max(0.12, c) calc((… |
--color-dark-magenta |
Dark mode magenta (+300° hue offset). | oklch( from var(--color-dark-foreground) clamp(0.64, l, 0.72) max(0.14, c) calc(… |
--color-dark-purple |
Dark mode purple (+270° hue offset). | oklch( from var(--color-dark-foreground) clamp(0.64, l, 0.72) max(0.13, c) calc(… |
--color-dark-pink |
Dark mode pink (+350° hue offset). | oklch( from var(--color-dark-foreground) clamp(0.68, l, 0.76) max(0.14, c) calc(… |
--color-dark-brown |
Dark mode brown (the dark orange, muted). | oklch( from var(--color-dark-orange) calc(l - 0.04) calc(c * 0.55) h ) |
--color-dark-accent-triadic |
Dark triadic accent (+120°). | oklch( from var(--color-dark-foreground) 0.68 max(0.16, min(0.2, c * 2)) calc((h… |
--color-dark-accent-auto |
Default dark accent strategy. | var(--color-dark-accent-triadic) |
--color-dark-accent |
Active dark mode accent color. | var(--color-dark-accent-auto) |
Per-scheme Overrides (optional hooks)
Foundation
The roles muted, subtle, border, shadow and highlight are computed once, from the active seeds (see Semantic Tokens). A theme that wants its own value for one scheme sets the matching hook; nothing is declared here, and an unset hook falls back to the formula.
| Name | Description |
|---|---|
--color-light-muted |
Optional light override for --color-muted (formula: foreground at 60% alpha). |
--color-dark-muted |
Optional dark override for --color-muted (foreground at 65% alpha). |
--color-light-subtle |
Optional light override for --color-subtle (foreground at 40% alpha). |
--color-dark-subtle |
Optional dark override for --color-subtle (foreground at 45% alpha). |
--color-light-border |
Optional light override for --color-border (foreground at 10% alpha). |
--color-dark-border |
Optional dark override for --color-border (darkened background at 25% alpha). |
--color-light-shadow-base |
Optional light override for --color-shadow. |
--color-dark-shadow-base |
Optional dark override for --color-shadow. |
--color-light-highlight |
Optional light override for --color-highlight. |
--color-dark-highlight |
Optional dark override for --color-highlight. |
Semantic Tokens
Foundation
Semantic color tokens consumed across all components and styles. Each role is declared once, as light-dark(<light seed>, <dark seed>), so which palette applies is decided by the element’s color-scheme: the system preference by default, or pinned with [data-color-mode="light|dark"], .theme-light, .theme-dark or .inverse. A themed container ([data-theme]) re-declares the roles, so it sees its own seeds. Requires light-dark() (Chrome 123, Safari 17.5, Firefox 120); older browsers get the light scheme. The status colours (--color-success, --color-warning, --color-error, --color-info) alias hues. Each has a background and a border tint, the status colour at a fixed opacity, for an alert, a badge or a highlighted row: the full colour stays the text and the icon. The tints are named with the CSS property, like --color-border-strong, because muted already means a text level.
| Name | Description | Value |
|---|---|---|
--color-background |
Active scheme root background. | light-dark(var(--color-light-background), var(--color-dark-background)) |
--color-foreground |
Active scheme text foreground. | light-dark(var(--color-light-foreground), var(--color-dark-foreground)) |
--color-accent |
Active scheme primary accent color. | light-dark(var(--color-light-accent), var(--color-dark-accent)) |
--color-header |
Heading text color. | light-dark( var(--color-light-header, var(--color-foreground)), var(--color-dark… |
--color-red |
Semantic red hue. | light-dark(var(--color-light-red), var(--color-dark-red)) |
--color-orange |
Semantic orange hue. | light-dark(var(--color-light-orange), var(--color-dark-orange)) |
--color-yellow |
Semantic yellow hue. | light-dark(var(--color-light-yellow), var(--color-dark-yellow)) |
--color-green |
Semantic green hue. | light-dark(var(--color-light-green), var(--color-dark-green)) |
--color-cyan |
Semantic cyan hue. | light-dark(var(--color-light-cyan), var(--color-dark-cyan)) |
--color-blue |
Semantic blue hue. | light-dark(var(--color-light-blue), var(--color-dark-blue)) |
--color-magenta |
Semantic magenta hue. | light-dark(var(--color-light-magenta), var(--color-dark-magenta)) |
--color-purple |
Semantic purple hue. | light-dark(var(--color-light-purple), var(--color-dark-purple)) |
--color-pink |
Semantic pink hue. | light-dark(var(--color-light-pink), var(--color-dark-pink)) |
--color-brown |
Semantic brown hue. | light-dark(var(--color-light-brown), var(--color-dark-brown)) |
--color-success |
Status color for success states (--color-green). |
var(--color-green) |
--color-warning |
Status color for warnings (--color-orange). |
var(--color-orange) |
--color-error |
Status color for errors (--color-red). |
var(--color-red) |
--color-danger |
Semantic error alias (--color-error). |
var(--color-error) |
--color-destructive |
Semantic error alias (--color-error). |
var(--color-error) |
--color-info |
Status color for informative notices (--color-blue). |
var(--color-blue) |
--color-chart-1 |
Series 1 of a chart or a map legend: blue, unless the theme says otherwise. Data, not a status. | var(--color-blue) |
--color-chart-2 |
Series 2 of a chart or a map legend: orange, unless the theme says otherwise. Data, not a status. | var(--color-orange) |
--color-chart-3 |
Series 3 of a chart or a map legend: green, unless the theme says otherwise. Data, not a status. | var(--color-green) |
--color-chart-4 |
Series 4 of a chart or a map legend: purple, unless the theme says otherwise. Data, not a status. | var(--color-purple) |
--color-chart-5 |
Series 5 of a chart or a map legend: cyan, unless the theme says otherwise. Data, not a status. | var(--color-cyan) |
--color-chart-6 |
Series 6 of a chart or a map legend: yellow, unless the theme says otherwise. Data, not a status. | var(--color-yellow) |
--color-chart-7 |
Series 7 of a chart or a map legend: pink, unless the theme says otherwise. Data, not a status. | var(--color-pink) |
--color-chart-8 |
Series 8 of a chart or a map legend: red, unless the theme says otherwise. Data, not a status. | var(--color-red) |
--color-link |
Active scheme link color. | light-dark(var(--color-light-link), var(--color-dark-link)) |
--color-on-accent |
Text color for elements over accent backgrounds. | var(--color-background) |
Computed Semantics
Foundation
Scheme-aware computed colors derived from active foreground and background seeds. Roles computed from the seeds at the role layer: there is no separate light and dark copy of the formula. A theme that wants its own value for one scheme sets the matching optional override (--color-light-muted, --color-dark-border, …); an unset override falls back to the formula. A theme sets seeds (--color-light-*, --color-dark-*), never a role directly: a role set directly has one value for both schemes.
| Name | Description | Value |
|---|---|---|
--color-muted |
Secondary text color (~60% alpha). | light-dark( var(--color-light-muted, rgb(from var(--color-light-foreground) r g … |
--color-subtle |
Tertiary text and decorative icon color (~40% alpha). | light-dark( var(--color-light-subtle, rgb(from var(--color-light-foreground) r g… |
--color-border |
Standard structural border color (~10% alpha). | light-dark( var(--color-light-border, rgb(from var(--color-light-foreground) r g… |
--color-surface |
Elevated surface and card background. | var(--color-surface-raised) |
--color-light |
Polarity alias resolving to lighter color of active scheme. | light-dark(var(--color-light-background), var(--color-dark-foreground)) |
--color-dark |
Polarity alias resolving to darker color of active scheme. | light-dark(var(--color-light-foreground), var(--color-dark-background)) |
--color-glass |
Frosted glassmorphism background color (~80% alpha). | rgb(from var(--color-background) r g b / 0.8) |
Surfaces & Elevation Colors
Foundation
Semantic elevation color seeds and surface hierarchy using perceptual OKLCH color spaces. Named after Atlassian’s elevation ladder (sunken, default, raised, overlay). Each level is the background shifted in OKLCH lightness, so it follows any theme and both schemes. Sunken is recessed, away from the viewer (wells, fields); raised is anything that sits on the ground (--color-surface is its short alias); overlay floats over a surface. A colour stops at white, so in a light scheme raised and overlay are often the same colour and the shadow tells them apart; dark schemes also lighten each level. Neighbouring levels must differ in colour or in shadow (tests/styles/elevation.test.mjs).
| Name | Description | Value |
|---|---|---|
--color-shadow |
Active base shadow color. | light-dark( var( --color-light-shadow-base, oklab( from var(--color-light-foregr… |
--color-highlight |
Active specular highlight color. | light-dark( var( --color-light-highlight, oklab(from var(--color-light-backgroun… |
--color-surface-sunken |
Recessed surface, 0.03 darker than the background (inputs, wells, code blocks). | oklab( from var(--color-background) max(0, calc(l - 0.015)) a b ) |
--color-surface-raised |
Raised surface, 0.03 lighter than the background (cards, panes, panels). | oklab( from var(--color-background) min(1, calc(l + 0.03)) a b ) |
--color-surface |
Short alias of --color-surface-raised. |
var(--color-surface-raised) |
--color-surface-overlay |
Floating surface, 0.06 lighter than the background (menus, popovers, dialogs). | oklab( from var(--color-background) min(1, calc(l + 0.06)) a b ) |
--color-fill |
Fill for thin shapes (the track of a slider): Apple’s systemFill, the foreground at 9.8 %. |
rgb(from var(--color-foreground) r g b / 0.098) |
--color-fill-secondary |
Small shapes (the backing of a progress bar): 7.8 %. | rgb(from var(--color-foreground) r g b / 0.078) |
--color-fill-tertiary |
Medium shapes (the backing of a switch): 4.7 %. | rgb(from var(--color-foreground) r g b / 0.047) |
--color-fill-quaternary |
Large areas (a group box): 2.7 %. | rgb(from var(--color-foreground) r g b / 0.027) |
--color-fill-quinary |
Large areas needing subtle emphasis (the content of a form): 0.8 %. | rgb(from var(--color-foreground) r g b / 0.008) |
--color-hover |
Pointer over an item. Apple defines no hover colour; this is its secondary fill. | var(--color-fill-secondary) |
--color-active |
Item being pressed (:active): the primary fill. |
var(--color-fill) |
--color-selected |
Selected item: Apple’s unemphasizedSelectedContentBackgroundColor as a foreground alpha, 14 % light / 18 % dark. |
light-dark( rgb(from var(--color-light-foreground) r g b / 0.14), rgb(from var(-… |
--color-placeholder |
Placeholder text: Apple’s placeholderTextColor, the foreground at 50 % light / 55 % dark. |
light-dark( rgb(from var(--color-light-foreground) r g b / 0.5), rgb(from var(--… |
--color-ring |
Keyboard focus ring: Apple’s keyboardFocusIndicatorColor, the accent at 50 %. |
rgb(from var(--color-accent) r g b / 0.5) |
--color-success-background |
Fill of a success alert, badge or highlighted row: the status colour at a low opacity. | rgb(from var(--color-success) r g b / 0.1) |
--color-success-border |
Edge of a success alert or badge: the status colour at a higher opacity. | rgb(from var(--color-success) r g b / 0.2) |
--color-warning-background |
Fill of a warning alert, badge or highlighted row: the status colour at a low opacity. | rgb(from var(--color-warning) r g b / 0.1) |
--color-warning-border |
Edge of a warning alert or badge: the status colour at a higher opacity. | rgb(from var(--color-warning) r g b / 0.2) |
--color-error-background |
Fill of a error alert, badge or highlighted row: the status colour at a low opacity. | rgb(from var(--color-error) r g b / 0.1) |
--color-error-border |
Edge of a error alert or badge: the status colour at a higher opacity. | rgb(from var(--color-error) r g b / 0.2) |
--color-info-background |
Fill of a informational alert, badge or highlighted row: the status colour at a low opacity. | rgb(from var(--color-info) r g b / 0.1) |
--color-info-border |
Edge of a informational alert or badge: the status colour at a higher opacity. | rgb(from var(--color-info) r g b / 0.2) |
--color-scrim |
Veil behind a modal surface: Apple’s dimming layer, black at 35 %. | rgb(0 0 0 / 0.35) |
--color-stage |
Backdrop behind media (photos, video, a canvas): neutral, 0.09 darker than the background, in both schemes. A theme may set --color-light-stage / --color-dark-stage. |
light-dark( var(--color-light-stage, var(--_stage)), var(--color-dark-stage, var… |
--color-surface-light-3 |
Numeric step, +0.09 (kept; no named level yet). | oklab( from var(--color-background) min(1, calc(l + 0.09)) a b ) |
--color-surface-dark-2 |
Numeric step, -0.06 (switch tracks, deep wells). | oklab( from var(--color-background) max(0, calc(l - 0.06)) a b ) |
--color-surface-dark-3 |
Numeric step, -0.09 (deepest insets). | oklab( from var(--color-background) max(0, calc(l - 0.09)) a b ) |
--color-surface-light-1 |
Legacy alias of --color-surface-raised. |
var(--color-surface-raised) |
--color-surface-light-2 |
Legacy alias of --color-surface-overlay. |
var(--color-surface-overlay) |
--color-surface-dark-1 |
Legacy alias of --color-surface-sunken. |
var(--color-surface-sunken) |
Border Shorthands
Foundation
Pre-composed border shorthand tokens for clean layout boundaries.
| Name | Description | Value |
|---|---|---|
--border |
Standard border shorthand (var(--stroke-width) solid var(--color-border)). |
var(--stroke-width) solid var(--color-border) |
--border-accent |
Tinted accent border shorthand. | var(--stroke-width) solid rgb(from var(--color-accent) r g b / 0.07) |
--border-transparent |
Transparent layout placeholder border. | var(--stroke-width) solid transparent |
All classes
Other
| Class | Declares |
|---|---|
.theme-light, .theme-dark |
color: var(--color-foreground) |
.inverse |
color-scheme: dark |
Utility classes
Extracted live from
_standard-50-utilities.scss. Every utility below maps directly to the semantic tokens above.
Colors: Text (semantic)
Text colour by role (.text-muted, .text-subtle, .text-accent read the colour roles: semantic tokens) and the font-family roles (.font-*).
| Class | Declares |
|---|---|
Aa.text-primary |
color: var(--color-foreground) !important |
Aa.text-muted, .muted |
color: var(--color-muted) !important |
Aa.text-subtle |
color: var(--color-subtle) !important |
Aa.text-accent |
color: var(--color-accent) !important |
Aa.font-text |
font-family: var(--font-text) !important |
Aa.font-monospace |
font-family: var(--font-monospace) !important |
Aa.font-serif |
font-family: var(--font-serif) !important |
Aa.font-sans |
font-family: var(--font-sans) !important |
Colors: Status
Text coloured by status: --color-success, --color-warning, --color-error, --color-info (Semantic tokens).
| Class | Declares |
|---|---|
Aa.success |
color: var(--color-success) !important |
Aa.warning |
color: var(--color-warning) !important |
Aa.error, .danger |
color: var(--color-error) !important |
Aa.info |
color: var(--color-info) !important |
Colors: Named spectrum (text)
Text coloured by hue, from --color-red to --color-pink (Semantic tokens).
| Class | Declares |
|---|---|
Aa.red |
color: var(--color-red) !important |
Aa.orange |
color: var(--color-orange) !important |
Aa.yellow |
color: var(--color-yellow) !important |
Aa.green |
color: var(--color-green) !important |
Aa.cyan |
color: var(--color-cyan) !important |
Aa.blue |
color: var(--color-blue) !important |
Aa.purple |
color: var(--color-purple) !important |
Aa.pink |
color: var(--color-pink) !important |
Backgrounds: Semantic
Backgrounds from the role and surface tokens (Surfaces and elevation), plus the translucent .bg-glass.
| Class | Declares |
|---|---|
.bg-background |
background-color: var(--color-background) !important |
.bg-surface |
background-color: var(--color-surface) !important |
.bg-accent |
background-color: var(--color-accent) !important |
.bg-foreground |
background-color: var(--color-foreground) !important |
.bg-transparent |
background-color: transparent !important |
.bg-glass |
backdrop-filter: var(--filter-glass) |
.bg-surface-raised, .bg-surface-light-1 |
background-color: var(--color-surface-raised) !important |
.bg-surface-overlay, .bg-surface-light-2 |
background-color: var(--color-surface-overlay) !important |
.bg-surface-light-3 |
background-color: var(--color-surface-light-3) !important |
.bg-surface-sunken, .bg-surface-dark-1 |
background-color: var(--color-surface-sunken) !important |
.bg-surface-dark-2 |
background-color: var(--color-surface-dark-2) !important |
.bg-stage |
background-color: var(--color-stage) !important |
.bg-surface-dark-3 |
background-color: var(--color-surface-dark-3) !important |
Backgrounds: Named spectrum
Backgrounds from the hue palette (Semantic tokens).
| Class | Declares |
|---|---|
.bg-red |
background-color: var(--color-red) !important |
.bg-orange |
background-color: var(--color-orange) !important |
.bg-yellow |
background-color: var(--color-yellow) !important |
.bg-green |
background-color: var(--color-green) !important |
.bg-cyan |
background-color: var(--color-cyan) !important |
.bg-blue |
background-color: var(--color-blue) !important |
.bg-purple |
background-color: var(--color-purple) !important |
.bg-pink |
background-color: var(--color-pink) !important |
Invert
.invert flips a subtree to the opposite colour scheme.
| Class | Declares |
|---|---|
.invert |
color: light-dark(var(--color-background), var(--color-foreground)) !important |
Shadows
Elevation as classes: each sets box-shadow to the matching --shadow-* token (Shadows and elevation). They are !important, so a utility wins over a component’s own shadow.
| Class | Declares |
|---|---|
.shadow |
box-shadow: var(--shadow) !important |
.shadow-raised |
box-shadow: var(--shadow-raised) !important |
.shadow-inset |
box-shadow: var(--shadow-inset) !important |
.shadow-xs |
box-shadow: var(--shadow-xs) !important |
.shadow-sm |
box-shadow: var(--shadow-sm) !important |
.shadow-md |
box-shadow: var(--shadow-md) !important |
.shadow-lg |
box-shadow: var(--shadow-lg) !important |
.shadow-xl |
box-shadow: var(--shadow-xl) !important |
.shadow-glow |
box-shadow: var(--shadow-glow) !important |
.shadow-ring |
box-shadow: var(--shadow-ring) !important |
.shadow-inset-ring |
box-shadow: var(--shadow-inset), var(--shadow-ring) !important |
.no-shadow |
box-shadow: none !important |
Borders
Border strokes (--border, --border-accent) and single sides.
| Class | Declares |
|---|---|
.border-0 |
border: 0 !important |
.border |
border: var(--border) !important |
.border-accent |
border: var(--border-accent) !important |
.border-t |
border-top: var(--border) !important |
.border-b |
border-bottom: var(--border) !important |
.border-l |
border-left: var(--border) !important |
.border-r |
border-right: var(--border) !important |
Border radius
Corners from --radius-sm, --radius and --radius-lg, and the fully round (Stroke, radius and filters).
| Class | Declares |
|---|---|
.rounded-sm |
border-radius: var(--radius-sm) !important |
.rounded |
border-radius: var(--radius) !important |
.rounded-lg |
border-radius: calc(var(--radius) * 1.5) !important |
.rounded-xl |
border-radius: calc(var(--radius) * 2) !important |
.rounded-full |
border-radius: 9999px !important |
.rounded-50, .rounded-50 img |
border-radius: 50% |
.no-rounded |
border-radius: 0 !important |