Skip to main content

Search rules

Search all UI Guides rules by name, category, or source

designimpeccable

No Gradient Text

NEVER

NEVER: Use `background-clip: text` (or `-webkit-background-clip: text`) with a gradient background and a transparent text color — the glyphs then have no color, so the selection highlight paints behind invisible letters and forced-colors mode can erase the heading entirely. Set one solid color and carry emphasis with weight or size.

Set headings in a single solid color and carry emphasis with weight or size, not a clipped gradient

Bad

Good

Why it matters

The detector looks for `background-clip: text` (or its `-webkit-` alias) paired with a gradient background and a transparent text color. The gradient is painted as the element's background and clipped to the glyphs, which means the text itself has no color: the selection highlight paints behind transparent letters and the words disappear while selected, and forced-colors mode strips the background image so the heading can vanish entirely.

The hue carries no information — it never encodes state, importance, or grouping — so a solid color plus a heavier weight or a larger size says the same thing without breaking selection and high-contrast users.

Built by Gleb Stroganov, design engineer at Evil Martians.

The rules come from other people's skills and guidelines — Vercel, Rauno Freiberg, @Ibelick, impeccable, Emil Kowalski, Tailwind, RAMS — each one credited on the Sources page. The work here is extraction and wiring: every rule is pulled into one corpus, given a good and a bad example you can operate, a MUST/SHOULD/NEVER rule an agent can paste, and a link back to where it came from.