2026-01-16 · architecture, web

How this site works (and why it stays small)

A second starter article — this one has "social": false in its meta.json, so it will never be syndicated to social networks. It exists to demonstrate the per-article opt-out and to hold the publishing workflow in one place.

Publishing a new article

1. mkdir input/articles/<slug>/ with an index.md and a meta.json (title, description, date are required; tags, social, draft are optional).
2. Preview locally with npm run dev.
3. npm run check, then commit and push to main.
4. GitHub Actions builds, checks, deploys to Cloudflare Pages, and syndicates the article to the configured social networks.

Editing an article later

Edit the Markdown and push. Re-deploys are cheap and the site is static, so there is nothing to invalidate. Editing a published article does not re-post it to social networks — the ledger in state/syndicated.json prevents that.