Color
Color is the loudest lever and the easiest to overuse. Hierarchy should already work in grayscale; color adds meaning, mood and one point of focus.
Build in this order
- Grayscale first. Lay out the design with neutrals only. If the hierarchy doesn't work without color, color won't fix it.
- Neutrals with temperature. Tint the grays toward the direction: warm (yellow-brown hues) for paper, craft and hospitality; cool (blue hues) for tools and technical work. Pure neutral gray rarely looks intentional.
- One accent. A single brand hue for the primary action, the current selection and the most important data. Spend it carefully.
- Semantic colors. Success, warning, danger and info, only where they mean something.
- Then, optionally, character. A second hue for illustration or section backgrounds, a limited palette, color-blocking. See "Color with character" below.
Ramps
Each hue gets a ramp of 9 to 11 steps (50, 100, 200 … 900, 950). Build ramps in OKLCH so steps look even:
- Keep the hue roughly constant; shift it a few degrees toward warmer at the dark end for yellows and oranges so they don't turn muddy.
- Step lightness evenly, from about 0.97 (50) to 0.2 (950).
- Chroma peaks in the middle steps (400–600) and falls toward both ends; very light and very dark colors can't hold much saturation.
Roles map to steps. In a light theme, for example:
| Role | Step |
|---|---|
| Page background | neutral 50 (or white for sharp, clean directions) |
| Raised surface | white or neutral 0–50 |
| Subtle fill, hover | neutral 100 |
| Border | neutral 200–300 |
| Tertiary text | neutral 500 (check contrast if it's real content) |
| Secondary text | neutral 600–700 |
| Primary text | neutral 900–950 |
| Accent fill | accent 500–600, text on it white or 950 |
| Accent text, links | accent 600–700 |
| Tinted badge | 100 background, 700–800 text, same hue |
Name tokens by role (surface, surface-raised, text, text-muted, border, accent, accent-contrast, danger) and point them at the ramp. Then a dark theme only has to remap the roles.
Proportion
Neutrals cover most of the screen, roughly 85 to 90%. The accent takes 5 to 10%: the primary button, the active state, a key number, one highlight. Semantic colors appear only where status exists. A design with three equally loud colors has no focal point.
Contrast
- Body text: at least 4.5:1 against its background. Large text (24px, or 19px bold): at least 3:1.
- Component boundaries and icons that convey meaning: at least 3:1.
- Text on a colored background: use a light or dark tint of that background's own hue, never mid-gray. Gray on blue looks dirty.
- Check accents used as text. Bright yellows, limes and cyans often fail on white; use their darker steps for text and keep the bright step for fills.
Dark themes
Dark isn't the light theme inverted:
- Use near-black tinted surfaces (#0E0F12, #121014), not pure black, unless the direction is OLED-stark on purpose.
- Raised surfaces get lighter, not shadowed: each level of elevation is a slightly lighter surface.
- Text is off-white (about 90 to 95% lightness), secondary text about 65 to 70%.
- Desaturate and lighten accents slightly; fully saturated colors vibrate on dark backgrounds.
- Borders are subtle: a surface step lighter, or white at 8 to 12% opacity.
- Recheck every contrast pair; dark themes fail in different places.
Color with character
Ways to make color part of the direction rather than decoration:
- An unexpected accent: vermilion, chartreuse, ultramarine, teal, ochre, plum, forest green. Not every product needs blue or violet.
- A strong neutral temperature: warm paper and ink, or cool concrete and steel, can carry a design on its own.
- A limited palette: two or three inks only, as in risograph printing, with overlaps that multiply into a third color.
- Monochrome: one hue in many steps, with the accent as the hue's most saturated step.
- Color-blocking: whole sections or halves of the screen in flat color, with type crossing between them.
- Tinted sections: each section of a long page in a different very light tint of the palette.
- Gradients with a reason: one hue to a neighboring hue, or a soft light source from one corner. Avoid rainbow gradients and the purple-to-blue default.
Palette starters
Starting points, to adjust for the subject. Check contrast before using an accent for text.
#F6F4EF #16181D #E8492B #6B7176
#F3F1EA #10142A #2B3FD6 #E9C46A
#F1EEE6 #13201A #2F6B4F #C8A15A
#F7EFE6 #2A1E18 #C4572E #6E7B5B
#FFFFFF #111111 #E4002B #9A9A9A
#FFF8EC #0F2A3D #1FB5D6 #FF8A5B
#F4EFE4 #1E1E1E #FF48B0 #0078BF
#0E0F0C #EDEFE6 #C6F432 #7A7F72
#17121C #F2ECF5 #D7A6F2 #8A7F91
#EDE9E3 #2B2A28 #8C6A43 #A39E96
Common color mistakes
- Using the accent on everything clickable, so nothing stands out.
- Red as the brand accent and also the error color, with no other distinction.
- Status shown by color alone, with no icon or text.
- Tints made by lowering opacity over varying backgrounds, so the same token looks different everywhere. Use solid tints.
- Shadows in pure black at high opacity. Tint shadows with the surface or text hue and keep them soft.