Section
Getting Started
Clone, build, contribute — your first half-hour with the Wheel of Heaven repos.
This section gets you from nothing to a working local copy of the main reading site in under five minutes, plus enough orientation that you know what each repo does before you start changing anything.
Three pages, in the order most readers want them:
- Quickstart — the fast path. Clone, install
mise, run the dev server. Includes the common stumbling blocks (SSH keys, port clashes, submodule init) so you spend zero time guessing. - Project Map — the 30-second tour of the ~19-repo organization. Which repo holds content, which holds the theme, which holds image processing, and how they connect. Read this before you wonder “where do I edit X?”
- Conventions — file names, branches, commits, markdown style, accessibility. Five minutes; saves the back-and-forth on your first PR.
If you’re a content author, do Quickstart + Project Map, then jump to Contributing → Content. If you’re working on the theme or pipelines, do Quickstart + Project Map, then Local Setup for the full environment.
- Quickstart From clone to live preview in under five minutes — the fast path for a first-time contributor.
- Project Map What each Wheel of Heaven repository does, and how they connect — the 30-second tour.
- Troubleshooting Common errors when getting set up locally — submodules, mise, port collisions, Zola, CF Pages — and how to unstick each.
- Conventions File names, branches, commits, code style — the small set of conventions everything else follows from.