Fair Case

Spacing and radius

Spacing uses one 4px unit in whole and half steps. Page padding grows with the window between two bounds. Corners come from a named radius scale. Layout changes at three breakpoints.

Spacing

One unit, 4px (0.25rem), in whole and half steps.

The package does not declare it: theme.css clears colour, font, text, radius and breakpoint defaults but leaves the framework's spacing alone. Components write p-4, gap-2, mt-6 and calc(var(--spacing) * n).

  • 0.52px
  • 14px
  • 1.56px
  • 28px
  • 2.510px
  • 312px
  • 416px
  • 520px
  • 624px
  • 728px
  • 832px
  • 936px
  • 1040px
  • 1144pxtouch target
  • 1248px
  • 1456px
  • 2496px

Page padding

One side padding for the site header and the homepage hero (decision 0087). It is full at the page edges and half between grouped blocks, and it grows with the window between a floor and a ceiling. Other routes still set their own padding today; moving them onto this one has not been decided.

The page padding rule
PartValueMeaning
Minimum0.75rem (12px)Held below 600px wide, where 2vw would be smaller.
Preferred2vw2% of the window's width, between the two bounds.
Maximum1.5rem (24px)Held from 1200px wide, where 2vw would be larger.
Halffull / 2Between grouped blocks.
The page padding at five window widths, with the floor and ceiling rows
WindowFullHalf
320pxfull 12px6px
390pxfull 12px6px
600px (floor)full 12px6px
768pxfull 15.36px7.68px
1024pxfull 20.48px10.24px
1200px (ceiling)full 24px12px
1440pxfull 24px12px

The widths assume a 16px root. The bounds are in rem, so a reader who enlarges their text also moves the two widths up. The padding is declared in the web app's stylesheet; this page reads it when the site builds.

On the site the padding follows the window's width. Here a frame stands in for the window, and the same clamp is written in container units, so the slider can change it. The frame is scaled down when it is wider than this column.

TSX and CSS

<header className="route-gutter">…</header>
<section className="route-gutter">…</section>

/* Between grouped blocks, in CSS */
gap: var(--route-padding-half);

Fluid sizing

Type and page padding grow smoothly between two rem bounds instead of jumping at breakpoints. Each fluid one is a clamp(): a minimum, a preferred value that follows the window's width, and a maximum. To change one, move its bounds or its slope; never swap in breakpoint steps. Reading and control text stays fixed on purpose. The size of every text role is in the Fluid sizes table.

Radius

Corners come from a named scale.

  • radius-44pxHeader links
  • radius-88pxTooltips
  • radius-1212pxApp sidebar rows
  • radius-1616pxMenus and popups
  • radius-2020pxThe page-list sheet
  • radius-2424px
  • radius-3232pxHomepage cards
  • radius-4040pxThe hero photo frame, smallest
  • radius-4848pxThe hero photo frame, largest
  • radius-6464px
  • radius-fullfullPills, buttons and chips

squircle-N draws the radius token times 1.194 with corner-shape: superellipse(1.3), and the plain token where the browser does not support it. Menus, notices, cards and the hero photo use it.

Breakpoints and widths

Breakpoints, widths and opacities
NameValueUse
md768pxBreakpoint
lg1024pxBreakpoint
xl1440pxBreakpoint
container-prose640pxmax-w-prose: running text width
container-page1200pxmax-w-page: page content width
opacity-disabled40%Disabled buttons and fields
opacity-photo0.1 light, 0.05 darkThe hero photo overlay
opacity-glow0.6 light, 0.08 darkThe hero glow

Use it well

  • Don't: Give the header or the homepage hero their own padding at fixed breakpoints, such as px-4 md:px-6. Use route-gutter, and var(--route-padding-half) for the gaps, so they move together.

  • To change the page padding, change its two bounds or its slope in the web app's stylesheet. Do not add breakpoint steps.

  • Spacing values appear only as Tailwind utilities and calc(var(--spacing) * n); there are no --fc-space tokens.

  • Breakpoints are written once, in theme.css; breakpoints.ts keeps scripts equal to them (decision 0075).

  • Radius scale: 4, 8, 12, 16, 20, 24, 32, 40, 48, 64 and full. The hero photo frame ranges from 40 to 48.

  • The only dimension tied to text size is 2.75rem for the phone header buttons; the lockup is drawn in px (decision 0104).

  • Colour changes ease over 300ms with ease-out; nothing moves on hover (transition-tone). The bottom sheet uses cubic-bezier(0.32, 0.72, 0, 1) over 240ms.