Colophon

Stack

Framework: Astro 7 — Static site generator with zero JS by default
Content: MDX — Markdown with embedded React for interactive sections
Styling: Vanilla CSS + custom properties. No frameworks, no preprocessors, no external fonts.
Package Manager: pnpm — Fast, space-efficient Node package manager
Hosting: Cloudflare Pages — Zero-config deployment, edge network
Version Control: GitHub — Source of truth, CI/CD trigger

Workflow

Development: Local: pnpm astro dev --background watches files and rebuilds on change
Editing: Neovim for code, Astro IDE extensions for feedback, browser dev tools
Content: MDX files in src/content/log/, numbered sequentially. Content schema defined in CLAUDE.md.
Building: pnpm build → static HTML/CSS/JS in dist/
Deploying: Git push to main triggers Cloudflare Pages build and deploy

Inspiration & References

This site was built with lessons from:

Robin Sloan — clarity, playfulness, and restraint in design
The Recompiler — thorough documentation of technical decision-making
Marginalia Search — minimal, fast, human-scale web tools