typography
Installation
SKILL.md
Typography
Overview
Ready-to-use type systems (Product UI, Editorial, Marketing, Docs/Technical) plus the methodology to size text, build scales, set vertical rhythm, and pick fonts — so generated UI is readable instead of tiny, thin, and low-contrast.
Core principle: size text by role on a scale, never by eyeballed pixels. Pick a base (16px), a ratio (~1.2), and derive every size from it — then keep every role above the readability floor, because most "impossible to read" output violates at least one of its four numbers.
The readability floor (the contract)
These are the recede-defaults. Meet all four and text is legible by construction; deviate only deliberately and name the reason (a 14px compact scale for genuine enterprise density is a legitimate reason — "it looked better" is not).
| Floor | Default | Why |
|---|---|---|
| Size | body ≥ 16px / 1rem | Browser default; iOS zooms <input> under 16px. Captions never < 14px — the hard floor for any text. |
| Weight | body ≥ 400 | Weights 100–300 thin the stroke and drop perceived contrast on small text. |
| Contrast | text ≥ 4.5:1 (large ≥ 3:1) | WCAG 2 AA. Re-check dark mode / thin fonts with APCA — WCAG2 overstates contrast near black. |
| Line-height | body ≥ 1.5 | Cramped leading hurts reading and fails the WCAG 1.4.12 spacing override. |