Design System

Spacing

An 8px rhythm on Tailwind's 4px scale. Compose with the scale — never arbitrary pixel values — so density stays consistent across products.

The scale

Tailwind step → rendered size. Steps above 4 should land on the 8px rhythm.

1
4px

Icon-to-label gaps, tight chip padding

2
8px

Gaps inside compact controls; the base rhythm unit

3
12px

Padding inside inputs and table cells

4
16px

Default gap between related elements; card padding (compact)

6
24px

Card padding (default); desktop grid gutters

8
32px

Gap between sibling groups inside a section

10
40px

Section padding on small screens

12
48px

Gap between page sections

16
64px

Hero / landing block separation

Rules of thumb

  • Related things sit closer than unrelated things — label to input at gap-1.5, field to field at gap-4, section to section at gap-12.
  • Prefer gap-* on the parent over per-child margins.
  • No p-[13px]-style arbitrary values — if a design calls for one, the design is off-scale, not the code.

On this page