colophon docs
← colophon docs

Internals & design notes

Engineering design documents for colophon's subsystems — how search, federation, webmentions and the Obsidian source work inside.

Design documents for the systems behind colophon. These are engineering notes, kept for the curious and for contributors — they explain why the subsystems are shaped the way they are, and can run ahead of or behind the shipped code.

  • Static search — the fully static lexical engine, index shards and the browser reader.
  • Federation — IndieWeb, POSSE and syndication architecture.
  • Webmention — sending, receiving, caching and displaying mentions.
  • Obsidian — publishing straight from a vault.

The roadmap itself lives in the repository: docs/PLAN.md.