$ cat colophon.md
Colophon
Colophon is the blogging platform this site runs on. It's small on purpose: a handful of parts, each with one job, and clear boundaries between them. This page is a top-level overview, and it will change as the platform does.
Writing
Every post and page is a plain markdown file kept in git, next to the code. Content is versioned, reviewed and diffed like any other change, and goes live with the next deploy. Git is the single source of truth.
Publishing
On publish, the files are synced into a database that acts as a fast, disposable read model. Markdown is turned into HTML once, at that point, and the search index is rebuilt along the way. If the database is ever lost, it can be rebuilt from the files.
Reading
Pages are served straight from that read model, so they're light and quick. There's site-wide search, tags and categories, and a light or dark theme. Most of the site is plain HTML. Interactive pieces are small islands embedded only where they add something, such as search or the like button.
Measuring
Each post counts its visits and likes, and nothing more: plain counters. For a week the site remembers, under an anonymous hash, that a reader read or liked a post, so a visit isn't counted twice and a like can be taken back. The site sets no cookies of its own. Cloudflare Web Analytics counts page views in aggregate, without cookies. The cookies page lists what is stored and why.
Running
Colophon runs serverless in the cloud: there are no servers to look after, and it costs next to nothing when idle. Development versions are only reachable after checking in, which keeps work in progress private.
Built with
Laravel, Livewire and Tailwind CSS, running on AWS Lambda.