Skip to content

Rule · Design

Too many distinct colors

design/palette-sprawlwarnvoid designupdated

Why it matters

Dozens of near-identical grays and tints mean colors were picked ad hoc instead of from a scale; the UI looks noisy and dark mode becomes impossible to maintain.

How to fix it

Use a 12-step neutral scale plus one accent scale exposed as semantic tokens (--bg, --surface, --fg, --fg-muted, --line, --brand…).

void design reports 19 rules in this category. Measured design heuristics from computed styles: font families, type scale, line length, palette and accent sprawl, spacing grid, radius sprawl, dark mode and the tells of generated UI.