{"type":"page","slug":"colophon","title":"Colophon","summary":"How waltspence.com works: the stack, the open-web features, and the design decisions.","published_at":"2026-09-02T00:00:00-04:00","revised_at":"2026-09-05T02:37:02-04:00","body_markdown":"This site is a publishing server. The web page you are reading is one of its interfaces.\n\n## Stack\n\n```text\nVue 3 (JavaScript, Vite) islands on server-rendered pages\n ↓\nRuby on Rails system of record, HTML, JSON, text, feeds, API\n ↓\nPostgreSQL content, relationships, full-text search\nRedis cache, Sidekiq queues, Action Cable, rate limiting\nPython / Node workers feed normalisation, transcripts, analysis (as needed)\n```\n\nRails renders a complete document for every public URL. Vue mounts small islands — the search palette, the live Thoughts stream, keyboard navigation, the theme toggle, chapter jumping in the player — only where they add something. Turn JavaScript off and the site still reads.\n\n## Objects and connections\n\nNotes, Thoughts, Projects, episodes, Goodies, pages and topics share one vocabulary: topics and tags, typed relationships between any two objects, revision history, and one search table. Links inside a body automatically become \"mentions\" relationships, so every page can show what points at it.\n\n## Open-web features\n\n- Atom and JSON Feed for everything and for each section; a feed per topic; RSS 2.0 with the podcast namespace for the show.\n- Every object as `.json`, `.txt` and, for long-form, `.md` with front matter. `Accept` headers work too.\n- A read-only JSON API at [/api/v1](/api/v1) that describes itself.\n- `llms.txt`, `humans.txt`, `robots.txt`, a sitemap, JSON-LD, OpenGraph, microformats2 (`h-entry`, `h-card`, `h-feed`).\n- A Webmention receiver. Verified mentions appear under the page they point at.\n- Stable permalinks. A URL only goes away if I take the post down.\n\n## Design\n\nThe site is set like the chart from a sleep study: a warm graphite ground that darkens down the page, warm white text, one amber accent. The chart at the top of every page is a hypnogram of this site's own publishing dates. Anybody sets the name and the headings, Public Sans the reading text, and IBM Plex Mono every label, date and line of code. There is no serif anywhere on the site. All three are self-hosted. The edition number counts everything ever published. Light mode is warm paper; add `?theme=light` to any URL to force it. Type does not move: hover changes colour and nothing else, and the one chart reveal stands down under `prefers-reduced-motion`.\n\n## Keyboard\n\n`/` search, `⌘K` palette, `j`/`k` through lists, `t` theme, `g n` notes, `?` help.\n\n## Terminal\n\nSee [/cli](/cli). `curl waltspence.com/now.txt` is the short version.\n\n## Source\n\nThe site's code is on [GitHub](https://github.com/waltspence). Content is [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) unless a page says otherwise.\n","body_html":"

This site is a publishing server. The web page you are reading is one of its interfaces.

\n

Stack

\n
Vue 3 (JavaScript, Vite)      islands on server-rendered pages\n    ↓\nRuby on Rails                 system of record, HTML, JSON, text, feeds, API\n    ↓\nPostgreSQL                    content, relationships, full-text search\nRedis                         cache, Sidekiq queues, Action Cable, rate limiting\nPython / Node workers         feed normalisation, transcripts, analysis (as needed)\n
\n

Rails renders a complete document for every public URL. Vue mounts small islands — the search palette, the live Thoughts stream, keyboard navigation, the theme toggle, chapter jumping in the player — only where they add something. Turn JavaScript off and the site still reads.

\n

Objects and connections

\n

Notes, Thoughts, Projects, episodes, Goodies, pages and topics share one vocabulary: topics and tags, typed relationships between any two objects, revision history, and one search table. Links inside a body automatically become “mentions” relationships, so every page can show what points at it.

\n

Open-web features

\n\n

Design

\n

The site is set like the chart from a sleep study: a warm graphite ground that darkens down the page, warm white text, one amber accent. The chart at the top of every page is a hypnogram of this site’s own publishing dates. Anybody sets the name and the headings, Public Sans the reading text, and IBM Plex Mono every label, date and line of code. There is no serif anywhere on the site. All three are self-hosted. The edition number counts everything ever published. Light mode is warm paper; add ?theme=light to any URL to force it. Type does not move: hover changes colour and nothing else, and the one chart reveal stands down under prefers-reduced-motion.

\n

Keyboard

\n

/ search, ⌘K palette, j/k through lists, t theme, g n notes, ? help.

\n

Terminal

\n

See /cli. curl waltspence.com/now.txt is the short version.

\n

Source

\n

The site’s code is on GitHub. Content is CC BY-SA 4.0 unless a page says otherwise.

\n","text":"This site is a publishing server. The web page you are reading is one of its interfaces.\nStack\nVue 3 (JavaScript, Vite) islands on server-rendered pages\n ↓\nRuby on Rails system of record, HTML, JSON, text, feeds, API\n ↓\nPostgreSQL content, relationships, full-text search\nRedis cache, Sidekiq queues, Action Cable, rate limiting\nPython / Node workers feed normalisation, transcripts, analysis (as needed)\n\nRails renders a complete document for every public URL. Vue mounts small islands — the search palette, the live Thoughts stream, keyboard navigation, the theme toggle, chapter jumping in the player — only where they add something. Turn JavaScript off and the site still reads.\nObjects and connections\nNotes, Thoughts, Projects, episodes, Goodies, pages and topics share one vocabulary: topics and tags, typed relationships between any two objects, revision history, and one search table. Links inside a body automatically become “mentions” relationships, so every page can show what points at it.\nOpen-web features\n\nAtom and JSON Feed for everything and for each section; a feed per topic; RSS 2.0 with the podcast namespace for the show.\nEvery object as .json, .txt and, for long-form, .md with front matter. Accept headers work too.\nA read-only JSON API at /api/v1 that describes itself.\nllms.txt, humans.txt, robots.txt, a sitemap, JSON-LD, OpenGraph, microformats2 (h-entry, h-card, h-feed).\nA Webmention receiver. Verified mentions appear under the page they point at.\nStable permalinks. A URL only goes away if I take the post down.\n\nDesign\nThe site is set like the chart from a sleep study: a warm graphite ground that darkens down the page, warm white text, one amber accent. The chart at the top of every page is a hypnogram of this site’s own publishing dates. Anybody sets the name and the headings, Public Sans the reading text, and IBM Plex Mono every label, date and line of code. There is no serif anywhere on the site. All three are self-hosted. The edition number counts everything ever published. Light mode is warm paper; add ?theme=light to any URL to force it. Type does not move: hover changes colour and nothing else, and the one chart reveal stands down under prefers-reduced-motion.\nKeyboard\n/ search, ⌘K palette, j/k through lists, t theme, g n notes, ? help.\nTerminal\nSee /cli. curl waltspence.com/now.txt is the short version.\nSource\nThe site’s code is on GitHub. Content is CC BY-SA 4.0 unless a page says otherwise.","url":"https://waltspence.com/colophon","links":{"html":"https://waltspence.com/colophon","json":"https://waltspence.com/colophon.json","txt":"https://waltspence.com/colophon.txt","md":"https://waltspence.com/colophon.md","canonical":"https://waltspence.com/colophon"},"revisions":[{"at":"2026-09-05T02:37:02-04:00","summary":"Revised"},{"at":"2026-09-05T02:31:04-04:00","summary":"Revised"},{"at":"2026-09-02T23:05:31-04:00","summary":"Revised"}]}