theme.json Design System
A constrained global design system — curated palettes and deliberately disabled controls — that makes the editor produce on-brand pages by default.
What it does
theme.json defines the platform’s global styles and, just as deliberately, the boundaries of editor freedom: content and wide measures, root-padding-aware alignment, and a small brand palette exposed only where it belongs — background colors on layout blocks, a short list of heading colors — with arbitrary color, border, spacing, and typography controls switched off.
Why it exists
On a governed platform, unrestricted design controls are how brand and accessibility erode one page at a time. Encoding the design system in theme.json makes the correct choices the default and the incorrect ones simply unavailable, so consistency is enforced by the platform itself rather than caught in review after the fact.
Engineering considerations
Built on theme.json version 3 with appearance tools and most global controls disabled, then re-enabled selectively per block — layout blocks receive the brand background palette, headings a constrained text palette, custom blocks their own controlled options. Layout is fixed to a 60rem content and 100rem wide measure with fluid root padding, so every template and pattern inherits the same spatial rhythm without editors needing to think about it.