Hello, world
Notes on how this site is built, and how to write for it.
This is the first post, mostly so the site isn’t empty. It doubles as a note-to-self on how everything works.
Writing
Every piece is a markdown file with a little frontmatter at the top:
---
title: On keeping a quiet room
date: 2026-09-10
description: One line for lists and search. # optional
tags: [attention, writing] # optional
draft: true # optional — hides it from the built site
---
Body goes here. Regular markdown.
Files live in src/content/essays/, src/content/poems/, or src/content/blog/. The filename becomes the URL, so on-keeping-a-quiet-room.md becomes /essays/on-keeping-a-quiet-room.
There’s a shortcut for starting a new piece:
npm run new essay "On keeping a quiet room"
That creates the file with today’s date and opens the frontmatter for you to fill in. Works with essay, poem, or post.
Publishing
Commit, push. Cloudflare builds the site and puts it online in about a minute. Nothing else to do.
Search
Press ⌘K (or /) anywhere. It searches titles instantly and full text once the site is built.