Contents

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

spacing tokens
TokenTailwindValueAbout
base --sb-space-base p-N, m-N, gap-N (the multiplier)0.3375remDensity 1.35x: step N = N x 0.25rem x 1.35 Derives from Generous spacing
0-5 --sb-space-0-5 CSS variable only0.1688rem Derives from Generous spacing
1 --sb-space-1 CSS variable only0.3375rem Derives from Generous spacing
1-5 --sb-space-1-5 CSS variable only0.5063rem Derives from Generous spacing
2 --sb-space-2 CSS variable only0.675rem Derives from Generous spacing
2-5 --sb-space-2-5 CSS variable only0.8438rem Derives from Generous spacing
3 --sb-space-3 CSS variable only1.0125rem Derives from Generous spacing
3-5 --sb-space-3-5 CSS variable only1.1813rem Derives from Generous spacing
4 --sb-space-4 CSS variable only1.35rem Derives from Generous spacing
5 --sb-space-5 CSS variable only1.6875rem Derives from Generous spacing
6 --sb-space-6 CSS variable only2.025rem Derives from Generous spacing
7 --sb-space-7 CSS variable only2.3625rem Derives from Generous spacing
8 --sb-space-8 CSS variable only2.7rem Derives from Generous spacing
10 --sb-space-10 CSS variable only3.375rem Derives from Generous spacing
22 --sb-space-22 CSS variable only7.425rem Derives from Generous spacing
28 --sb-space-28 CSS variable only9.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-1clamp(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-2clamp(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-3clamp(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-4clamp(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-5clamp(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-6clamp(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-7clamp(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-8clamp(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-9clamp(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-10clamp(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-11clamp(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-12clamp(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-13clamp(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-14clamp(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-bottommax(var(--sb-space-3), env(safe-area-inset-bottom))Composer bottom padding above a home indicator Derives from Generous spacing
size tokens
TokenTailwindValueAbout
control-xs --sb-size-control-xs p-control-xs, m-control-xs, gap-control-xs, size-control-xs, h-control-xs, w-control-xs1.75remxs 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-sm2.25remsm 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-md2.5remDefault 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-lg2.75remlg 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-width2pxFocus 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-offset2pxFocus 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-hairline1pxEvery 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-width40remDialog 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-width28remHome, 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-width80remDesktop 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-top12vhDialog 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