Skip to Content
FoundationColors

Colors

SolarUI uses Radix UI Colors as its color foundation. Every color is a 12-step scale carefully designed for accessible contrast, predictable usage, and automatic dark mode — no dark: overrides needed in your components.

The 12-step scale

Each color family has 12 steps with precise semantic roles:

StepRoleTypical use
1App backgroundbody, page root
2Subtle backgroundCards, panels, sidebars
3UI component backgroundDefault state of inputs, popovers
4Hovered component backgroundHover on interactive items
5Active / selected backgroundSelected list item, pressed state
6Subtle borderSeparators, card borders
7Component borderForm inputs, default focus ring
8Hovered borderStrong border, hover on border
9Solid backgroundSolid buttons, badges
10Hovered solid backgroundHover on solid buttons
11Low-contrast textSecondary labels (accessible on light background)
12High-contrast textBody text, headings

SolarUI tokens

SolarUI maps 6 semantic groups to Radix color families. These generate 72 Tailwind utilities (bg-default-1text-info-12):

Token groupRadix familyRole
defaultgraySurfaces, borders, body text
brandorangePrimary actions, highlights
errorredDestructive, invalid states
successgreenConfirmation, positive feedback
warningamberWarnings, caution states
infoskyInformational, neutral highlights
1
2
3
4
5
6
7
8
9
10
11
12
default(gray)
brand(orange)
error(red)
success(green)
warning(amber)
info(sky)
// Surfaces and text <p className="text-default-12">Main text</p> <p className="text-default-11">Secondary / muted text</p> <div className="bg-default-2 border border-default-6">Card</div> // Brand — primary actions <button className="bg-brand-9 text-brand-1 hover:bg-brand-10">Save</button> // Error state <div className="bg-error-3 text-error-11 border border-error-7"> Invalid field </div> // Success, warning, info follow the same pattern <Badge className="bg-success-9 text-success-1">Active</Badge> <Badge className="bg-warning-9 text-warning-1">Pending</Badge> <Badge className="bg-info-9 text-info-1">Beta</Badge>

Dark mode is handled automatically by Radix UI Colors. Importing *-dark.css files sets the same CSS variables under .dark, so all bg-default-*, text-brand-* etc. classes switch seamlessly — no dark: prefix required in your components.


Full Radix UI palette

All 33 Radix color families, grouped by hue. Hover any swatch to see its step number and hex value.

Grays

1
2
3
4
5
6
7
8
9
10
11
12
Gray
Mauve
Slate
Sage
Olive
Sand

Reds & Pinks

1
2
3
4
5
6
7
8
9
10
11
12
Tomato
Red
Ruby
Crimson
Pink

Purples & Blues

1
2
3
4
5
6
7
8
9
10
11
12
Plum
Purple
Violet
Iris
Indigo
Blue

Greens

1
2
3
4
5
6
7
8
9
10
11
12
Cyan
Teal
Jade
Green
Grass
Mint
Sky

Warm

1
2
3
4
5
6
7
8
9
10
11
12
Lime
Yellow
Amber
Orange

Metals

1
2
3
4
5
6
7
8
9
10
11
12
Brown
Bronze
Gold

The palette above shows light-mode values. Radix provides a matched dark scale for every color. See Composing Palettes to learn how to choose colors that harmonize across light and dark.

Last updated on