How This Website Is Built

The Cachespan website follows one rule from our engineering principles: prefer the simplest architecture that correctly solves the current problem. For a site of this size, that means hand-authored pages built on the web platform itself — each one a file you could read in a text editor, including this one.

Simplicity here is a sizing decision, not a doctrine. As the website grows, its architecture is expected to grow with it: technologies will be adopted when a real problem calls for them, and each addition must earn its place by creating measurable value. What will not change is the order of the questions — first what the problem is, then what the simplest correct answer looks like.

A design system in custom properties

Every color, spacing step, type size, and radius on this site is a CSS custom property defined in a single tokens file, derived from our design system documentation. Components never hardcode values — they reference tokens. The stylesheet is layered the same way the site is thought about: variables, base element styles, layout, then components.

The recurring visual motif — a thin gradient line running from bronze through steel to cyan — encodes the brand itself: past, present, and future in one stroke. It appears under the hero, above the footer, and across the era timeline, always as an accent and never as decoration.

Built to last

The payoff is longevity. A page whose behavior lives in the platform rather than in tooling will keep working, unchanged, years from now — and anyone who opens the repository can understand all of it in an afternoon. Accessibility is treated as a requirement, not polish: semantic landmarks on every page, visible focus styles, reduced-motion support, and text contrast checked against WCAG AA on our dark palette.

AI is part of the engineering workflow at Cachespan: it automates repetitive work and assists implementation across our repositories, this site included. Engineering judgment remains human — important decisions are reviewed before they become part of the project, and nothing ships on the strength of a suggestion alone. The website is deployed through Cloudflare Pages, and it will grow the way everything at Cachespan grows: deliberately.

← Back to Devlog