# 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

1. **Grayscale first.** Lay out the design with neutrals only. If the hierarchy doesn't work without color, color won't fix it.
2. **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.
3. **One accent.** A single brand hue for the primary action, the current selection and the most important data. Spend it carefully.
4. **Semantic colors.** Success, warning, danger and info, only where they mean something.
5. **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.

| Name                | Background | Text    | Accent  | Second  | Feel                     |
| ------------------- | ---------- | ------- | ------- | ------- | ------------------------ |
| Ink & vermilion     | #F6F4EF    | #16181D | #E8492B | #6B7176 | editorial, precise       |
| Ultramarine archive | #F3F1EA    | #10142A | #2B3FD6 | #E9C46A | institutional, scholarly |
| Forest & bone       | #F1EEE6    | #13201A | #2F6B4F | #C8A15A | calm, outdoors, finance  |
| Clay studio         | #F7EFE6    | #2A1E18 | #C4572E | #6E7B5B | craft, warm utility      |
| Swiss signal        | #FFFFFF    | #111111 | #E4002B | #9A9A9A | structured, bold         |
| Pool party          | #FFF8EC    | #0F2A3D | #1FB5D6 | #FF8A5B | playful, consumer        |
| Riso duo            | #F4EFE4    | #1E1E1E | #FF48B0 | #0078BF | culture, events          |
| Night shift         | #0E0F0C    | #EDEFE6 | #C6F432 | #7A7F72 | technical, dark          |
| Plum velvet         | #17121C    | #F2ECF5 | #D7A6F2 | #8A7F91 | creative, dark           |
| Stone gallery       | #EDE9E3    | #2B2A28 | #8C6A43 | #A39E96 | luxury, quiet            |

## 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.
