the lab
about the site

Colophon

Some notes on how this site is built, and the decisions that shaped how it looks.

This is Lab — a slow, statically generated workshop where I think about software design in public. It's not a blog and it's not a dashboard. The closest analogues are a researcher's notebook and a desk piled with index cards.

The reading column is set in ET Book, a digital revival of Bembo, with Inter for chrome and small metadata. The paper is a warm off-white in the day and a candlelit near-black at night — the dark mode is sepia, on purpose: when I'm reading at midnight I don't want a screen pretending to be a forge.

Building blocks

Built with Astro and MDX. There is intentionally no client-side state, no analytics, and no JavaScript framework — just HTML and CSS, with one tiny island for the search overlay and the hover popovers.

Conventions I follow

  • Margin notes appear in the right gutter on wide screens and collapse to inline footnotes on narrow ones. They're for asides, not for warnings.
  • Wiki-style references like [[some thing]] are resolved at build time. Hover any of them to see a small preview; click to follow.
  • Areas replace tags. Each document is filed under one or more areas, never under arbitrary tags.
  • No counters. No view counts, no read times, no popularity indicators. Either a thing is here or it isn't.

The full design rationale lives in DESIGN.md at the root of the repository.