Input
Default branded build
Designers and developers create the intended interface first, with semantic HTML and a clean token map.
Engine
Principle
Input
Designers and developers create the intended interface first, with semantic HTML and a clean token map.
Contract
Components reference variables for colour, type, spacing, surfaces, and layout instead of hard-coding them locally.
Runtime
JavaScript holds the user state, applies the matching data attributes, and updates CSS custom properties live.
Result
The same page changes around the user without DOM rewrites, page reloads, or layout collapse.
Before
When components own their own colours, spacing, and typography, accessibility changes become expensive and fragile.
.panel {
background: #ffffff;
color: #223667;
padding: 24px;
border-radius: 12px;
}
.panel h2 {
font-family: "Brand Sans", sans-serif;
}
After
Teams build against tokens and semantic structure so the engine can reshape the interface safely at runtime.
.panel {
background: var(--colour-surface);
color: var(--colour-text);
padding: var(--space-lg);
border-radius: var(--radius-md);
}
.panel h2 {
font-family: var(--font-family-active);
}
frontend/
styles/
base/
layout/
components/
themes/
scripts/
pages/
assets/
State and storage
State shape
{
appearance: "default",
contrast: "contrast-light",
font: "legible",
filter: "warm",
fontScale: 120,
lineSpacing: 130,
paragraphSpacing: 140,
letterSpacing: 4,
wordSpacing: 6,
readingWidth: "focused",
reducedMotion: true,
reducedTransparency: true,
focusBoost: true,
underlineLinks: true
}
Storage route
default build
-> token contract
-> runtime engine
-> local preference store
-> optional signed-in profile sync
-> interface re-renders through CSS variables
The current implementation persists locally. Later, the same model can support signed-in profile sync without changing the front-end contract.
How it can be used
We build the site, define the token map, and include the engine as part of the finished system.
We audit an existing interface, replace brittle hard-coded rules, and install the engine in phases.
The engine can be supplied with templates, starter systems, and implementation guidance for teams that want a strong starting point.
Accessibility controls
Shape the interface around real reading, comfort, and visibility needs without reloading the page.