How this site is built

A quick note on how this site works, mostly so future-me remembers.

The stack

The whole thing is built with Astro, a static-site framework that ships almost no JavaScript by default. Pages are plain HTML by the time they reach your browser, which makes the site fast and cheap to host.

Each blog post — including this one — is just a Markdown file in src/content/blog/. To publish something new, I add a file, write, and push. Astro turns it into a page at a clean URL automatically.

Writing a post

Every post starts with a small block of frontmatter:

---
title: 'How this site is built'
description: 'A quick look under the hood.'
pubDate: 2026-07-12
---

Then I write in Markdown. Headings, bold, lists, links, inline code, and code blocks all just work.

Hosting

The site is hosted on Cloudflare Pages, connected to a GitHub repository. Every time I push to the main branch, Cloudflare rebuilds and deploys in about a minute. It’s free, fast, and handles the custom domain and HTTPS for me.

That’s the entire setup. Simple on purpose — the point is to write, not to fiddle with infrastructure.