Foundations
Spacing and size
A 4px grid at 1.35 times the density, fluid gutters for phones, and fixed sizes for everything you tap.
Spacing follows Generous spacing. Step N is N x 0.25rem x 1.35, so p-4 is 1.35rem (21.6px). The steps are deliberately not multiples of 4px; do not round them. In Tailwind every step comes from the one --spacing multiplier, so p-4, gap-1.5 and -space-x-2 all land on the scale.
Steps
0-5 · 0.1688rem
1 · 0.3375rem
1-5 · 0.5063rem
2 · 0.675rem
2-5 · 0.8438rem
3 · 1.0125rem
3-5 · 1.1813rem
4 · 1.35rem
5 · 1.6875rem
6 · 2.025rem
7 · 2.3625rem
8 · 2.7rem
10 · 3.375rem
22 · 7.425rem
28 · 9.45rem
safe-bottom · max(var(--sb-space-3), env(safe-area-inset-bottom))
Fluid steps
Page gutters and section padding shrink on phones with p-fluid-N. The clamp() lives only in the token, never at a usage site. Each bar is drawn at the current window width.
fluid-1
fluid-2
fluid-3
fluid-4
fluid-5
fluid-6
fluid-7
fluid-8
fluid-9
fluid-10
fluid-11
fluid-12
fluid-13
fluid-14
Sizes
Fixed dimensions sit on the 4px grid. control-xs is the smallest thing you may make tappable, and control-lg is the coarse-pointer target for the player and other primary touch controls.
control-xscontrol-smcontrol-mdcontrol-lg
Tokens
| Token | Tailwind | Value | About |
|---|---|---|---|
| base --sb-space-base | p-N, m-N, gap-N (the multiplier) | 0.3375rem | Density 1.35x: step N = N x 0.25rem x 1.35 Derives from Generous spacing |
| 0-5 --sb-space-0-5 | CSS variable only | 0.1688rem | Derives from Generous spacing |
| 1 --sb-space-1 | CSS variable only | 0.3375rem | Derives from Generous spacing |
| 1-5 --sb-space-1-5 | CSS variable only | 0.5063rem | Derives from Generous spacing |
| 2 --sb-space-2 | CSS variable only | 0.675rem | Derives from Generous spacing |
| 2-5 --sb-space-2-5 | CSS variable only | 0.8438rem | Derives from Generous spacing |
| 3 --sb-space-3 | CSS variable only | 1.0125rem | Derives from Generous spacing |
| 3-5 --sb-space-3-5 | CSS variable only | 1.1813rem | Derives from Generous spacing |
| 4 --sb-space-4 | CSS variable only | 1.35rem | Derives from Generous spacing |
| 5 --sb-space-5 | CSS variable only | 1.6875rem | Derives from Generous spacing |
| 6 --sb-space-6 | CSS variable only | 2.025rem | Derives from Generous spacing |
| 7 --sb-space-7 | CSS variable only | 2.3625rem | Derives from Generous spacing |
| 8 --sb-space-8 | CSS variable only | 2.7rem | Derives from Generous spacing |
| 10 --sb-space-10 | CSS variable only | 3.375rem | Derives from Generous spacing |
| 22 --sb-space-22 | CSS variable only | 7.425rem | Derives from Generous spacing |
| 28 --sb-space-28 | CSS variable only | 9.45rem | Derives from Generous spacing |
| fluid-1 --sb-space-fluid-1 | p-fluid-1, m-fluid-1, gap-fluid-1, size-fluid-1, h-fluid-1, w-fluid-1 | clamp(0rem, 2vw, 1.5rem) | Derives from Generous spacing |
| fluid-2 --sb-space-fluid-2 | p-fluid-2, m-fluid-2, gap-fluid-2, size-fluid-2, h-fluid-2, w-fluid-2 | clamp(1rem, 2.5vw, 1.5rem) | Derives from Generous spacing |
| fluid-3 --sb-space-fluid-3 | p-fluid-3, m-fluid-3, gap-fluid-3, size-fluid-3, h-fluid-3, w-fluid-3 | clamp(1.25rem, 3vw, 2rem) | Derives from Generous spacing |
| fluid-4 --sb-space-fluid-4 | p-fluid-4, m-fluid-4, gap-fluid-4, size-fluid-4, h-fluid-4, w-fluid-4 | clamp(1rem, 3vw, 2.5rem) | Derives from Generous spacing |
| fluid-5 --sb-space-fluid-5 | p-fluid-5, m-fluid-5, gap-fluid-5, size-fluid-5, h-fluid-5, w-fluid-5 | clamp(1.1rem, 4vw, 2.5rem) | Derives from Generous spacing |
| fluid-6 --sb-space-fluid-6 | p-fluid-6, m-fluid-6, gap-fluid-6, size-fluid-6, h-fluid-6, w-fluid-6 | clamp(1.5rem, 3vw, 2.5rem) | Derives from Generous spacing |
| fluid-7 --sb-space-fluid-7 | p-fluid-7, m-fluid-7, gap-fluid-7, size-fluid-7, h-fluid-7, w-fluid-7 | clamp(1.25rem, 4vw, 3rem) | Derives from Generous spacing |
| fluid-8 --sb-space-fluid-8 | p-fluid-8, m-fluid-8, gap-fluid-8, size-fluid-8, h-fluid-8, w-fluid-8 | clamp(1rem, 4vw, 3.5rem) | Derives from Generous spacing |
| fluid-9 --sb-space-fluid-9 | p-fluid-9, m-fluid-9, gap-fluid-9, size-fluid-9, h-fluid-9, w-fluid-9 | clamp(1.5rem, 4vw, 4rem) | Derives from Generous spacing |
| fluid-10 --sb-space-fluid-10 | p-fluid-10, m-fluid-10, gap-fluid-10, size-fluid-10, h-fluid-10, w-fluid-10 | clamp(2rem, 5vw, 4rem) | Derives from Generous spacing |
| fluid-11 --sb-space-fluid-11 | p-fluid-11, m-fluid-11, gap-fluid-11, size-fluid-11, h-fluid-11, w-fluid-11 | clamp(1.5rem, 4vw, 4.5rem) | Derives from Generous spacing |
| fluid-12 --sb-space-fluid-12 | p-fluid-12, m-fluid-12, gap-fluid-12, size-fluid-12, h-fluid-12, w-fluid-12 | clamp(2rem, 5vw, 4.5rem) | Derives from Generous spacing |
| fluid-13 --sb-space-fluid-13 | p-fluid-13, m-fluid-13, gap-fluid-13, size-fluid-13, h-fluid-13, w-fluid-13 | clamp(2.5rem, 7vw, 5rem) | Derives from Generous spacing |
| fluid-14 --sb-space-fluid-14 | p-fluid-14, m-fluid-14, gap-fluid-14, size-fluid-14, h-fluid-14, w-fluid-14 | clamp(2rem, 5vw, 5.5rem) | Derives from Generous spacing |
| safe-bottom --sb-space-safe-bottom | p-safe-bottom, m-safe-bottom, gap-safe-bottom, size-safe-bottom, h-safe-bottom, w-safe-bottom | max(var(--sb-space-3), env(safe-area-inset-bottom)) | Composer bottom padding above a home indicator Derives from Generous spacing |
| Token | Tailwind | Value | About |
|---|---|---|---|
| control-xs --sb-size-control-xs | p-control-xs, m-control-xs, gap-control-xs, size-control-xs, h-control-xs, w-control-xs | 1.75rem | xs buttons, sm toggles, xs avatars; the minimum interactive target (WCAG 2.2 AA floor is 24px) Derives from Generous spacing |
| control-sm --sb-size-control-sm | p-control-sm, m-control-sm, gap-control-sm, size-control-sm, h-control-sm, w-control-sm | 2.25rem | sm buttons, menu items, default toggles, sm avatars Derives from Generous spacing |
| control-md --sb-size-control-md | p-control-md, m-control-md, gap-control-md, size-control-md, h-control-md, w-control-md | 2.5rem | Default buttons, inputs, select trigger, md avatars Derives from Generous spacing |
| control-lg --sb-size-control-lg | p-control-lg, m-control-lg, gap-control-lg, size-control-lg, h-control-lg, w-control-lg | 2.75rem | lg buttons; also the 44px coarse-pointer target for player and primary touch controls Derives from Generous spacing |
| focus-width --sb-size-focus-width | p-focus-width, m-focus-width, gap-focus-width, size-focus-width, h-focus-width, w-focus-width | 2px | Focus outline width (D-18) Derives from Readable in both themes |
| focus-offset --sb-size-focus-offset | p-focus-offset, m-focus-offset, gap-focus-offset, size-focus-offset, h-focus-offset, w-focus-offset | 2px | Focus outline offset (D-18) Derives from Readable in both themes |
| hairline --sb-size-hairline | p-hairline, m-hairline, gap-hairline, size-hairline, h-hairline, w-hairline | 1px | Every border Derives from Flat |
| dialog-max-width --sb-size-dialog-max-width | p-dialog-max-width, m-dialog-max-width, gap-dialog-max-width, size-dialog-max-width, h-dialog-max-width, w-dialog-max-width | 40rem | Dialog width cap Derives from Generous spacing |
| form-max-width --sb-size-form-max-width | p-form-max-width, m-form-max-width, gap-form-max-width, size-form-max-width, h-form-max-width, w-form-max-width | 28rem | Home, join and notice column Derives from Generous spacing |
| room-max-width --sb-size-room-max-width | p-room-max-width, m-room-max-width, gap-room-max-width, size-room-max-width, h-room-max-width, w-room-max-width | 80rem | Desktop room grid Derives from Generous spacing |
| dialog-offset-top --sb-size-dialog-offset-top | p-dialog-offset-top, m-dialog-offset-top, gap-dialog-offset-top, size-dialog-offset-top, h-dialog-offset-top, w-dialog-offset-top | 12vh | Dialog top offset; also caps dialog height at 100dvh minus twice the offset. 96px is the fallback for tools without viewport units Derives from Generous spacing |