cat ./colophon.md
Colophon
How this site is built — and the principles it refuses to break.
This site is deliberately lean. It practises what the guides preach: no surveillance, no bloat, and nothing loaded that you didn't ask for. If a feature can't be added without breaking one of the principles below, it doesn't get added.
Principles
- Zero cookies. No consent banner, because there's nothing to consent to.
- No third-party tracking. Analytics, when used, are privacy-first and cookie-free.
- Self-hosted assets. Fonts and scripts are served from here — never a third-party CDN.
- A 95+ PageSpeed budget, defended by shipping as little client JavaScript as possible.
Stack
Built with Astro (static output) and the Keystatic CMS, with content authored in Markdoc. It's deployed to Cloudflare Pages. Source of truth for what runs the servers I write about lives on the uses page.
Design
The palette is Nord. Type is Fraunces for display and IBM Plex Sans / Mono for everything else — all self-hosted via Fontsource. Code blocks use Shiki with a matched dark/light theme, plus diff, line-highlight and filename headers for the config-heavy guides.
Under the hood
- Social share cards and Mermaid diagrams are rendered to static images at build time — zero client JS.
- Search is Pagefind: a static index, queried entirely in the browser, no server.
- Reading progress for the courses is remembered in
localStorage— not a cookie. - The build itself gates on content + link integrity, so a broken cross-link can't ship.
Spotted something off, or curious how a piece works? The security contact and my inbox are both open.