Hello, world

This is the first post on the new site. Mostly it’s here so the listing, the post template, and the RSS feed have something real to render — but it also doubles as a quick note on how the site works.

How posts work

Every post is a Markdown file under src/content/posts/. The filename becomes the URL slug, and the frontmatter is validated against a schema at build time, so a typo in date: will fail the build instead of producing a broken page.

The minimum frontmatter is:

---
title: Your post title
date: 2026-05-21
---

Optional fields: description (used by the post list and RSS feed), tags, and draft: true (hides the post in production builds while keeping it visible in npm run dev).

Publishing

git add src/content/posts/2026-05-21-my-post.md
git commit -m "post: my post"
git push

GitHub Actions takes it from there.

← all writing