better-typography · v5.0.0 · 2026-09-19 · sha256 823ef622552bdc45
better-typography v5.0.0A
Immutable. This exact content never changes and is served at /api/v1/blob/823ef622552bdc45.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_qwan3rz5i75hpqhc/823ef622552bdc45a8d70abbc6fe3421ba3cc4e13ec52b5cf07b4637801179b6.json
Then /plugin install better-typography@markdownregistry-qwan3rz5i75hpqhc in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
---
name: better-typography
description: "Use when Web typography from choosing fonts to spacing, wrapping, and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, styling text in components, truncating text, styling underlines, selection, placeholders, or carets. Triggers on typography, fonts, variable fonts, font-weight, opentype, letter-spacing, line-height, type scale, tabular numbers, text-wrap, truncation, line clamp, measure, line length."
version: 5.0.0
last-updated: 2026-09-13
tools: Read, Grep, Glob, Bash, Edit, Write
scripts-binding:
- .agent/scripts/lint_runner.js
- .agent/scripts/verify_all.js
---
# Better Typography — Web Typography & Font Engineering
---
## 🛠️ Technical Architecture & Reference Recipes
---
## 1. Modular Type Scales & Line Cadence
Scale font sizes using a consistent multiplier ($1.25$ Major Third or $1.20$ Minor Third):
```css
:root {
--font-size-xs: 0.75rem; /* 12px - Labels, Badges */
--font-size-sm: 0.875rem; /* 14px - Meta, Caption */
--font-size-base: 1rem; /* 16px - Body Text */
--font-size-lg: 1.125rem; /* 18px - Lead Body */
--font-size-xl: 1.375rem; /* 22px - Subheadings */
--font-size-2xl: 1.75rem; /* 28px - H3 */
--font-size-3xl: 2.25rem; /* 36px - H2 */
--font-size-4xl: 3rem; /* 48px - H1 Hero */
/* Line Heights proportional to font size */
--line-height-heading: 1.15;
--line-height-body: 1.5;
--line-height-tight: 1.25;
}
```
---
## 2. Line Length (Measure) & Text Wrapping
- **Optimal Line Length (Measure)**: Body text MUST be constrained between **45 to 75 characters** per line (`max-width: 65ch`).
- **Heading Balancing**: Always apply `text-wrap: balance` to headings (`h1`-`h4`) to eliminate single-word widows.
- **Paragraph Wrapping**: Use `text-wrap: pretty` for long body paragraphs to prevent awkward line breaks.
```css
h1,
h2,
h3,
h4 {
text-wrap: balance;
letter-spacing: -0.025em;
line-height: var(--line-height-heading);
}
p {
max-width: 65ch;
text-wrap: pretty;
line-height: var(--line-height-body);
}
```
---
## 3. OpenType Features & Tabular Numbers
- **Tabular Numbers for Data & Timers**: Use `font-variant-numeric: tabular-nums` (or `tnum`) for data tables, counters, prices, and timestamps so numbers align vertically without jumping when values update.
- **Font Smoothing**: Enable crisp font smoothing on macOS/iOS:
```css
body {
-webkit-font-smoothing: antialiased;
-moz-osx-font-smoothing: grayscale;
}
```
---
## Anti-Slop Table
| Anti-Pattern | Typography Solution | Rationale |
| ------------------------------------------- | ------------------------------------ | ------------------------------------------------ |
| Full-width body text (`width: 100%`) | `max-width: 65ch` | Prevents eye fatigue across wide desktop screens |
| Single-word widows on headings | `text-wrap: balance` | Creates balanced visual hierarchy |
| Jittering numbers in data tables | `font-variant-numeric: tabular-nums` | Keeps columns strictly aligned |
| Default browser line-height (`1.2` on body) | `line-height: 1.5` | Improves reading comfort |