Colors

Components use semantic tokens named by role, never raw palette steps. Every token carries its light and dark value, so the same class is right in both themes.

Neutral temperature

An experiment: lean the neutrals warm or cold and the whole site follows. The middle is pure grey; Shipped is what palette.css has now. Copy the CSS when a pair feels right.

Light mode
Cold 20
Dark mode
Cold 75

Layers

What a region sits on. Pick by role, not by how gray it looks.

canvas App background and page content
chrome Sidebar and app header
surface Cards, tables and panels on the canvas
overlay Menus, popovers and dialogs

Controls

Inputs and secondary buttons share one fill, so a field and a button read as the same kind of thing.

control Inputs, selects, secondary buttons
control-hover Their hover state

Fills

Translucent neutral fills that work on any layer.

fill Table headers, quiet badges, tracks
fill-hover Hover on rows, nav items, ghost buttons
fill-active Pressed and selected

Text

Most text is fg. Muted for secondary text, subtle for hints.

A
A
fg Body text, labels, headings
A
A
fg-muted Descriptions, secondary text, icons
A
A
fg-subtle Placeholders, hints, group labels

Lines

Layout dividers use border-subtle. Control edges use border.

border-subtle Layout dividers, rows, card edges
border Inputs and secondary buttons
border-strong Hover edges and emphasis
ring Focus ring

Intents

Each intent has the same six tokens: a solid fill, its hover, text on the fill (-fg), colored text (-text), a tinted background (-subtle) and its edge (-border).

primary
primary-subtle
danger
danger-subtle
warning
warning-subtle
success
success-subtle
info
info-subtle
primary
primary-subtle
danger
danger-subtle
warning
warning-subtle
success
success-subtle
info
info-subtle

Palette

The raw ramps behind the tokens. Use them only to define a token.

base Neutral, light theme
50
100
200
300
400
500
600
700
800
900
950
gray Neutral, dark theme
50
100
200
300
400
500
600
700
800
900
950
brand 700 is the primary, #006c99
50
100
200
300
400
500
600
700
800
900
950
danger
50
100
200
300
400
500
600
700
800
900
950
warning
50
100
200
300
400
500
600
700
800
900
950
success
50
100
200
300
400
500
600
700
800
900
950
info
50
100
200
300
400
500
600
700
800
900
950