Skip to content
GitHub
Sections

Reference · Things to avoid

Depth built from shadow in dark mode

Forbidden
The same shadow tokens carried into dark mode to lift cards off the page
Instead
In dark mode, elevation comes from the background colour — bg-base → bg-raised → bg-overlay, each lighter than the last. Shadows are close to invisible on a dark surface. --shadow-raised resolves to none in dark for exactly this reason.

What this rule looks like

Forbidden
Instead

Why this rule

Also: shadow colour derives from the text colour, never pure black, so it sits inside the palette rather than on top of it.

Kind
Rule
Section
Things to avoid
Group
Colour and contrast
Bucket
judgment
Severity
note
Since
v0.1.0

Read as plain text