Skip to content
Back home
Colophon

How this site is built

The site sells verified software, so the site itself is built and checked the same way. This page states the mechanisms.

Stack

  • Next.js: every page is prerendered to static HTML at build time. No server compute per request.
  • Tailwind CSS: all colour, type, and spacing values are defined once as tokens and referenced everywhere.
  • Fonts: Space Grotesk, Inter, and JetBrains Mono, self-hosted. No external font requests, no layout shift.
  • Weight: about 102 kB of shared JavaScript on first load, almost all of it the framework baseline.

Standards

Four documents in the repository govern every change. Copy follows the Google developer documentation style guide, adapted in a project style file, under a strict truth rule: the site claims only what the code does, and every number traces to code or a source. The visual system, language rules, and working practices each have their own policy file. Conflicts resolve in one order: truth, then clarity, then theme.

Checks

  • A style check blocks banned punctuation and marketing language from the copy. It runs in CI on every push, next to a full build.
  • The same check confirms that every page in the sitemap is listed in the machine-readable index, so the two cannot drift apart.
  • Accessibility floor: WCAG AA contrast, visible focus rings, a skip link, and reduced-motion support.

The machine-readable layer

AI assistants and search engines read this site as often as people do, so the facts ship in formats they can parse.

  • llms.txt: a plain-text index of the site for AI assistants.
  • Structured data: Person, Article, WebSite, and BreadcrumbList schemas on the relevant pages.
  • RSS feed for the writing, and a sitemap.