Skip to content
GitHub
Sections

Reference · Things to avoid

Decorative styling that implies meaning

Forbidden
List items in assorted colours chosen for variety; a decorative icon beside a heading that looks pressable; a heading coloured and underlined though it is not a link
Instead
Style carries information or it goes. People assume differences mean something — arbitrary colour invites them to hunt for a pattern that does not exist, and an icon that looks interactive will be clicked.

What this rule looks like

Forbidden
Instead

Why this rule

Decoration is allowed. Decoration that mimics a functional signal is not.

Kind
Rule
Section
Things to avoid
Group
Generic-AI aesthetic
Bucket
judgment
Severity
note
Since
v0.1.0

Read as plain text