a builder's codex
codex · playbooks · Design principles playbook

Design principles playbook

Architectural diagram · five design levers

Design Principles for Marketing Assets

Visual hierarchy
Three levers: size, weight, colordesign in grayscale first; add color only after hierarchy works without it
De-emphasize labels, emphasize valuesin "Revenue: $4.2M" the number wins; the label is secondary
Von Restorff effectCTA must use a distinct color used nowhere else on the page
Hierarchy levels must be perceptibly differentif H2 is 24px, H3 is 20px — not 22px
Typography
Constrained scale12 · 14 · 16 · 20 · 24 · 30 · 36 · 48px only
Line length 60–80 characterswider = harder to read; narrower = choppy
Body leading 1.4–1.6never below 1.4; never above 1.8
Left-align body textcenter-aligned body breaks both F and Z scanning patterns
Spacing + color
4px base unit gridall spacing values are multiples of 4
Fewer borders, more spacingborders add visual noise; spacing communicates grouping cleanly
Contrast minimum 4.5:1text on background; WCAG AA for all user-facing assets
Border-radius 4px max for B2Brounded corners read as consumer; square reads as professional

Actionable rules for non-designers producing landing pages, emails, ads, decks, social, and collateral. Every rule has a specific value. Source synthesis: Refactoring UI, WCAG, classic Gestalt principles.

When to use

Any visual asset before publish. Pair with the messaging matrix output, copy first, then design.

1. Visual hierarchy, three levers

Size, weight, color. Design in grayscale first. Add color only after hierarchy works without it.

LeverPrimarySecondaryTertiary
Size24–36px16–20px12–14px
Weight600–700500400
ColorDark high-contrast (#1a1a1a)Medium grey (#6b7280)Light grey (#9ca3af)

2. Typography

Constrained scale. Recommended: 12, 14, 16, 20, 24, 30, 36, 48px.

RoleSizeWeightLine-height
Display/H136–487001.0–1.1
H230600–7001.1–1.2
H3246001.2–1.25
Body164001.5–1.6
Small144001.4–1.5

Line length 50–75 characters; 66 is the sweet spot. Mobile 35–50 acceptable. Two font families max. Sans-serif default for B2B SaaS.

3. Color

4. Spacing

5. Tap targets and accessibility

6. CTA discipline

7. Components and consistency

Quality gates

Common failure modes

Open the interactive view →