Design Token System
We build a design token layer that defines your colour palette, typography scale, spacing system, border radii, and shadow levels as named variables in SCSS and CSS custom properties. Every component in the theme references these tokens. A brand update changes the tokens. Nothing else needs touching.
Gutenberg Block Library
We build a library of custom Gutenberg blocks specific to your site's content patterns. Each block is designed for your brand, coded to produce predictable output, and scoped so editors cannot accidentally break the layout. The block library replaces the core blocks that were not working for your team and supplements the ones that were.
Block Pattern Library
We build a set of pre-composed block patterns, full sections assembled from your custom blocks, that editors can insert and populate without making layout decisions. Common page sections, call-to-action rows, testimonial layouts, feature grids, and content-media pairs are all available as one-click insertions with your brand applied.
ACF Field Groups
We integrate Advanced Custom Fields to give editors structured control over page-level data that is not well-suited to block content: SEO overrides, hero background options, sidebar configurations, related content selections, and any custom data your templates require. ACF fields are documented so editors understand what each field does without needing to ask a developer.
SCSS Architecture
We build the theme's stylesheet as a well-organised SCSS codebase: partials for tokens, base styles, layout, components, and utilities, with a clear naming convention. Any developer who joins your team after handover will be able to navigate and extend the stylesheet without a lengthy onboarding.
Performance Optimisation
We audit and optimise every asset loaded by the theme: fonts loaded with font-display: swap and preloaded correctly, no unused JavaScript, CSS scoped to the components that need it, images using modern formats with appropriate srcset attributes, and Core Web Vitals verified on WP Engine UK, Kinsta, or SpinupWP before handover.
Accessible HTML
We build to WCAG 2.1 AA. Semantic heading structure, aria labels on interactive elements, keyboard-navigable components, sufficient colour contrast across all token combinations, and focus states that are visible and styled. Accessibility is built into the HTML structure, not retrofitted as a plugin.
Browser Testing
We test on Chrome, Firefox, Safari, and Edge on both desktop and mobile. We test on real iOS and Android devices alongside emulators. We document and fix any layout or functionality issues before handover.
Git Handover and Editorial Documentation
We hand over the theme on Git with a clean commit history, a README covering the token system, block library, and deployment process, and editorial documentation written for your content team. The editorial documentation covers how to use every custom block and pattern, what each ACF field does, and how to add new pages correctly. It is written for editors, not developers.