Skip to main content

Search rules

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

contentVercel

Inline Help First

SHOULD

SHOULD: Inline help first; tooltips last resort

Prefer inline explanations; use tooltips as last resort

Bad

Good

Why it matters

Tooltips hide information and require hovering, which doesn't work on touch devices. Whenever possible, include help text inline where it's always visible. Use tooltips only for supplementary information that would clutter the interface.

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.