Tokens

Radiant UI tokens are CSS custom properties in three tiers. Components consume semantic and geometry roles. Each complete theme supplies the palette and shape values behind those roles.

Click a swatch to copy its CSS variable. Values follow the selected complete theme and light/dark mode. Choose a theme from the button beside the mode toggle, or use the gallery below.

Each theme brings its own palette and component treatment. Choose one here to preview its tokens and components across this page, then open the Theming guide for package imports and the Radiant Default color controls.

Choose a visual theme

Preview each theme with its own colors, typography, spacing, shape, and component details. Build your own, with fonts and a copyable setup, in the theme lab.

Radiant DefaultRadiant default, cool and quiet
GitHubClean surfaces and clear status colors
CloudflareQuiet neutral layers, blue actions, and amber accents
VS CodeEditor-inspired light and dark modes
VercelLayered monochrome surfaces and clear component states
Material DesignExpressive color, rounded controls, and tonal surfaces
High ContrastBlack and white surfaces with AAA text contrast
Windows 95Classic raised controls, title bars, and selection states
Mac OS ClassicPlatinum controls and striped title bars
macOSLayered native-inspired surfaces and accent states
ZedFlat, dense editor surfaces with quiet accent states

Available themes include Radiant Default, GitHub, Cloudflare, VS Code, Vercel, Material Design, High Contrast, Windows 95, Mac OS Classic, macOS, and Zed. Each complete theme also has an individually exported compact variant, such as @ecopages/radiant-themes/github/compact.

Token tiers

TierWhat it isPublic contract
1. PacksRaw scales: colour palettes, --space-*, --border-radius-*, elevation, type, motionImport a pack stylesheet. Do not target palette steps from component CSS.
2. Semantic--primary, --surface, --error, … plus the Tailwind @theme bridge (bg-primary)This is what components use.
3. SystemAbsolute colours (--color-black, --color-white), border widths, focus ring geometry, opacity, z-index, control and icon sizesShared by every theme; not a mood pack. Radiant Default sets its own sizes; other packs alias the spacing scale.

themes/default.css is the default import graph. It loads the Radiant Default palette, spacing and radius, elevation, typography, motion, system tokens, and semantic roles. tokens/foundation.css contains the shared foundation tokens.

Colour roles

These are the roles components consume. Tailwind utilities map from the same names: --primary → bg-primary, text-on-primary, border-primary. Pair chips show the on-* colour as text on the fill.

destructive is an alias of error (--color-destructive: var(--error)). Use error for status surfaces and destructive for destructive actions such as buttons.

Tertiary has fill and container roles only. It does not ship --tertiary-light or --tertiary-dark.

Brand

Primary, secondary, and tertiary families. Components consume these roles, not palette steps.

Status

Notification and validation families. destructive aliases error.

Surfaces

Page and container backgrounds with matching on-colours.

Supporting

Chrome, focus, links, overlays, and code surfaces.

FamilyCSS variables
Brand--primary, --on-primary, --primary-container, --on-primary-container, --primary-light, --primary-dark, --secondary, --on-secondary, --secondary-container, --on-secondary-container, --secondary-light, --secondary-dark, --tertiary, --on-tertiary, --tertiary-container, --on-tertiary-container
Status--error, --on-error, --error-container, --on-error-container, --error-light, --error-dark, --success, --on-success, --success-container, --on-success-container, --success-light, --success-dark, --info, --on-info, --info-container, --on-info-container, --info-light, --info-dark, --warning, --on-warning, --warning-container, --on-warning-container, --warning-light, --warning-dark
Surfaces--background, --on-background, --surface, --on-surface, --surface-container-lowest, --on-surface-container-lowest, --surface-container-low, --on-surface-container-low, --surface-container, --on-surface-container, --surface-container-high, --on-surface-container-high, --surface-container-highest, --on-surface-container-highest
Supporting--border, --focus-ring, --on-focus-ring, --link, --overlay, --neutral, --background-code, --on-background-code
Range tracks--rui-track-mix (45%), --rui-track-fill; optional --rui-track-color

Gray scale

--gray-50 through --gray-950 are the neutral scale exposed as Tailwind utilities (bg-gray-50, …). Each theme maps this scale to its own neutral family; Radiant UI's default uses Radiant Default.

gray

Source palettes

Palette files put raw colors on :root. Theme role files assign them to semantic roles. Component CSS must not reference palette values such as --color-carbon-blue-500 or --color-github-blue.

The Radiant Default scales are derived from OKLCH seed variables in @ecopages/radiant-ui/themes/default. Optional palettes such as GitHub, Cloudflare, VS Code, Vercel, Material Design, High Contrast, Windows 95, Mac OS Classic, macOS, and Zed are provided by @ecopages/radiant-themes. Hue scales that include step 975 ship steps 50–975; Vercel gray and the semantic gray scale end at 950. --color-black and --color-white are system tokens, not a hue pack.

Cloudflare

@ecopages/radiant-themes/cloudflare

Cloudflare colors

Radiant Default

@ecopages/radiant-ui/tokens/colors/rui-default

rui-default
carbon-blue
carbon-violet
carbon-red
carbon-green
carbon-amber

Material Design

@ecopages/radiant-themes/material

Material Design role seeds
Material Design surfaces

GitHub

@ecopages/radiant-themes/github

GitHub colors

VS Code

@ecopages/radiant-themes/vscode

VS Code colors

Vercel

@ecopages/radiant-themes/vercel

vercel-gray
Vercel colors

High Contrast

@ecopages/radiant-themes/high-contrast

High Contrast colors

Windows 95

@ecopages/radiant-themes/windows95

Windows 95 colors

Mac OS Classic

@ecopages/radiant-themes/macos-classic

Mac OS Classic colors

macOS

@ecopages/radiant-themes/macos

macOS colors

Zed

@ecopages/radiant-themes/zed

Zed colors

Spacing

Spacing uses --space-1 through --space-16 and five roles. Bars show the live computed size for the selected theme. Radiant Default scales with its density control; each Radiant Themes compact export composes a denser spacing scale while preserving the theme's own color, shape, and typography.

Roles are what component CSS should use for control padding and stack rhythm:

TokenRadiant DefaultTailwind @theme
--space-10.1875rem--spacing-1
--space-20.375rem--spacing-2
--space-30.625rem--spacing-3
--space-40.8125rem--spacing-4
--space-51rem--spacing-5
--space-61.25rem--spacing-6
--space-81.75rem--spacing-8
--space-102remnot bridged
--space-122.5remnot bridged
--space-163.25remnot bridged
--space-control-x--space-3--spacing-control-x
--space-control-y--space-2--spacing-control-y
--space-inline--space-2--spacing-inline
--space-stack--space-4--spacing-stack
--space-inset--space-4--spacing-inset

--size-control-sm, --size-control-md, and --size-control-lg are 1.75rem, 2rem, and 2.25rem (28, 32, and 36px) in Radiant Default and follow --rui-density, so density affects button and input height as well as --space-control-x padding. The compact, comfortable, and wide packs alias --space-8, --space-10, and --space-12 instead. Radiant Default also sets --text-control to 0.8125rem.

--space-10, --space-12, and --space-16 exist as CSS variables but are not mapped in the spacing @theme bridge. Use var(--space-10) or a role token when a value should follow the selected theme's density.

Radius

Radius tokens set --border-radius-* and three roles: --radius-control, --radius-container, --radius-pill. The @theme bridge exposes rounded-sm, rounded-control, rounded-container, and rounded-pill. Complete themes provide their own shape values; only Radiant Default exposes --rui-radius-scale as a tuning input. rounded-button aliases --radius-control.

Elevation

TokenUse
--shadow-controlResting controls
--shadow-overlayPopovers, menus, dropdowns
--shadow-modalDialogs

The flat pack sets all three shadows to none: @ecopages/radiant-ui/tokens/elevation/flat.

Typography

The shared type scale includes size, leading, weight, and tracking tokens. Complete themes provide --font-sans, --font-heading, and --font-mono; the selected theme controls those stacks. Load the shared scale with @ecopages/radiant-ui/tokens/typography/default, or import a complete theme to get its matching font families too.

TokenDefault
--text-xs0.75rem
--text-sm0.875rem
--text-body1rem
--text-label0.875rem
--text-control0.875rem
--text-lg1.125rem
--text-xl1.25rem
--text-2xl1.5rem
--text-3xl1.875rem
--text-4xl2.25rem

Motion

TokenDefaultSnappy
--duration-fast150ms100ms
--duration-normal200ms150ms
--duration-slow300ms200ms
--ease-standardcubic-bezier(0.4, 0, 0.2, 1)same
--ease-incubic-bezier(0.4, 0, 1, 1)same
--ease-outcubic-bezier(0, 0, 0.2, 1)same
@import '@ecopages/radiant-ui/tokens/motion/snappy';

System

Shared structural tokens from @ecopages/radiant-ui/tokens/system. Not a swappable mood pack. Absolute black and white live here so theme roles can reference them without depending on a palette pack.

absolute
TokenValue
--color-blackoklch(0% 0 0)
--color-whiteoklch(100% 0 0)
--border-width-hairline1px
--border-width-thin1px
--border-width-thick2px
--rui-track-mix45%
--rui-track-fillcolor-mix of --on-background at --rui-track-mix
--focus-ring-width2px
--focus-ring-offset2px
--opacity-disabled0.5
--opacity-muted0.6
--z-dropdown10
--z-popover20
--z-overlay30
--z-modal40
--z-toast50
--size-control-sm1.75rem in Radiant Default; other packs alias var(--space-8)
--size-control-md2rem in Radiant Default; other packs alias var(--space-10)
--size-control-lg2.5rem in Radiant Default; other packs alias var(--space-12)
--size-icon-sm1rem
--size-icon-md1.25rem

accessibility.css is part of the default foundation. It adds a base visible focus outline that component themes can customize, honors prefers-reduced-motion, strengthens borders when prefers-contrast: more is enabled, and maps semantic colors to system colors under forced-colors: active. High Contrast is available from Theming and targets AAA contrast for the published semantic text pairs in light and dark modes.

Compose packs in the application stylesheet. See Theming.