Spacing

Spacing

A 13-step spacing scale on a 16px base. Numeric — space-1 through space-13 — gives one canonical answer per layout decision.

Scale

TokenValueCommon use
space-12pxHairline gutter (rare; usually borders only)
space-24pxInline element gap
space-38pxParagraph rhythm floor; icon-label gap
space-412pxForm field padding
space-516pxBody grid unit; default container padding
space-624pxCard padding; vertical rhythm between sections
space-732pxSection gutter
space-840pxWider section gap
space-948pxMajor section break
space-1064pxPage-level section
space-1180pxPage-level section (looser)
space-1296pxPage-level section (loosest)
space-13160pxHero / landing-page-only spacing

Composition

Compose larger spacing from the scale, never invent off-scale values:

  • 4px + 12px + 4px = space-2 + space-4 + space-2 for a labelled field
  • Card with 24px padding: space-6
  • Section break with title above and content below at 32px each: space-7 × 2

Off-scale values (5px, 14px, 22px) break the rhythm and accumulate as drift. The 13-step scale is dense enough to cover every layout need without resorting to off-scale.

Layout floor

The substrate uses a 16px (space-5) baseline grid. Body text and headings align to multiples of 16px in their line-height calculation; container padding aligns to multiples of 16px in the inline axis. This is structural — it ensures vertical rhythm remains consistent across surfaces.