The book is BOOK.md. One file, about 3,950 lines.
It describes how the system works and why it works that way, in enough detail to build a functionally identical one from scratch. It says almost nothing about visual design, because the visual design follows from the mechanics.
Part I argues the design. Parts II and III are the mechanics. Part IV is every page. Part V is operating it. Part VI records what was refused and why. Part VII is written in Simplified Technical English and shows the exact commands for every task. Part VIII is building and running it. The appendices hold the ref layout, the config schema, the route table, the hook pseudocode and the CLI reference.
The three programs the book describes:
| Repo | Binary | What it is |
|---|---|---|
| server | barerepo |
the forge you install |
| cli | br |
an optional shortcut for git commands |
| runner | barerepo-runner |
the build machine agent |
The code is the source of truth. Where this book and the code disagree, the code is right and the book is a bug.