Production FSE Theme
The custom Full-Site-Editing theme behind a large multi-site federal platform — conventions-first, dependency-light, and governed end to end.
What it does
A single custom Full-Site-Editing theme provides the entire editorial and presentation layer for a large multi-site federal platform: block templates and template parts, a governed editor, roughly seventy production patterns, a constrained design system in theme.json, and the supporting PHP, SCSS, and JavaScript. Editors build and maintain pages through curated patterns and blocks — the theme defines what is possible, and the platform stays consistent as a result.
Why it exists
A platform at this scale is judged on consistency and maintainability, not features. Building the presentation layer as one theme rooted in core WordPress conventions — rather than a page builder or a stack of third-party plugins — keeps the platform portable, upgrade-safe, and legible to the next engineer who inherits it. Curation and governance are treated as architecture, so hundreds of pages and many editors stay on-system without continuous oversight.
Engineering considerations
The architecture is deliberately modular and convention-driven. PHP is split into single-concern function files loaded from a thin manifest; SCSS is organized to mirror the theme’s own template, part, and pattern vocabulary and compiled with dart-sass; block styling extends core blocks rather than introducing new ones; and third-party dependencies are minimized on principle. Every decision favors the properties enterprise ownership actually rewards — a codebase a team can reason about, extend safely, and hand off.