Colophon
How this site is built.
Every page here is static HTML generated at build time. This is what it runs on, and the few decisions worth explaining.
- 71
- posts
- 199
- hand-written charts
- 506
- links between posts
- last built
Type and colour
Headings are set in Bricolage Grotesque, a variable typeface whose optical-size axis adjusts the letterforms to the size they are set at. Body text is Hanken Grotesk. The palette is a warm off-white and near-black with one ink-blue accent, kept for links, focus and selection. Dark mode is designed rather than inverted: every chart carries its own dark palette.
Writing and publishing
Posts are MDX files in the repository, checked against a schema at build time, so a missing description or a malformed date fails the build instead of shipping. A post's date is its publish time. Future-dated posts stay out of the build until a scheduled job rebuilds the site at 00:05 UTC each day.
Charts and diagrams
Charts are SVG written by hand inside each post, not exported images. Every mark is tagged with its role (bar, axis, label), which is how dark mode recolours them and how they draw in as you scroll to them. With reduced motion turned on, they stay still.
Images
Each post's cover is a still life built around one object from its title, generated by an image model from a written brief and held to one style: matte materials, a pale palette, no text. Share images are separate: a 1200 by 630 card for every page, rendered at build time with Satori and resvg in the same typefaces as the site.
Getting around
Search runs in your browser against an index built with the site; press ⌘K or Ctrl K. The same palette jumps to sections of the post you are reading, switches theme, and opens a random post. Moving between the home page and a post uses the browser's view transitions, so the cover and title carry across. Hovering a link to another post previews it, from data already in the page, so nothing is fetched.
Analytics and privacy
Analytics are first-party, handled by a small serverless function, with no cookies and no third-party scripts. If your browser sends Do Not Track or Global Privacy Control, nothing is recorded, and known bots are ignored. Otherwise a visit records the page, time on page, referrer and country. Visitors are counted by a hash of IP address and browser string under a salt that changes every day, so a visitor cannot be followed from one day to the next, and the IP address itself is never stored. Records are deleted after 90 days.
Stack
Astro, Tailwind CSS, Shiki for code highlighting, MiniSearch, Biome and Bun, hosted on Netlify. Files with content-hashed names are cached for a year; pages are revalidated on every visit, so a fix is live as soon as it deploys.