Hello, world
This file is a template, not a real post. It exists so the build has something to aggregate and so you (or an agent) can see the shape of a post at a glance. Replace this content with your own writing.
Every post is a self-contained posts/<slug>/index.html
folder. Open it directly in a browser and it just works — no build step needed
to read it. The aggregator only reads the six <head> tags
above; the body is entirely yours.
To publish a new post
- Copy this folder to
posts/your-slug/. - Edit the six head tags (title, og:title, og:description, published_time,
keywords, canonical — point canonical at
/posts/your-slug/). - Write the body however you like. Drop images beside this file.
- Run
npm run buildand previewdist/. - Commit and push — Cloudflare rebuilds and deploys automatically.
What the house style gives you
Code samples are highlighted at author time with .tok-* spans —
no JavaScript ships to the reader (see styles/DESIGN.md):
// The whole aggregator contract, in one line each:
const title = metaBy(head, "property", "og:title") ?? titleOf(head) ?? slug;
const date = metaBy(head, "property", "article:published_time") ?? "";
And when an AI agent drafts text for a page, it must be wrapped so nobody can mistake it for the author's writing:
Like this! BMO wrote this little box. The author writes
the real posts; BMO only builds the machinery they sit on.