日本語版は準備中です。このページは英語版を表示しています。
The engine repo (daiyanze/breaker-delta) holds code only — never any instance's collected data. Your editions, ledger, track record and config live in your own data repo; its CI checks out the engine, builds the site from your data, and deploys to the data repo's own GitHub Pages. Upgrading the engine never touches your data.
your-data-repo/ editions/ # one file per edition state/ # ledger, vocabulary, sitemap baselines track-record.md # the pick ledger config.yaml # your config (optional; the engine example is the fallback) .github/workflows/pages.yml # build and deploy to this repo's Pages
The working reference is daiyanze/breaker-delta-data: clone its shape, point it at your own data, and the radar is yours.
The official instance now runs on Cloudflare Pages (projects connected straight to the repos, built on every push): the main project connects to the data repo and clones the engine during its build, the docs project connects to the engine repo and builds directly, each with its own domain (breakerdelta.com and docs.breakerdelta.com). The build commands are exactly the ones above — only the runner changed from GitHub to Cloudflare; self-hosters can pick either platform.
The official domains are split on purpose: the main site sits at the apex (breakerdelta.com — the boards and topic pages are public content that lives on sharing and search, and the apex is the cleanest address for both); the docs are a separate site (docs.breakerdelta.com — this site, built and deployed by its own docs repo running the docs command, never bundled into the main build; the main site's Docs tab simply links here); and the app. subdomain is reserved for a future logged-in product. For your own instance the same shape applies: point TS_BASE_URL at your apex, and either link to the official docs or build your own copy with the docs command.
A data repo's CI uses its own default token, which cannot read a private repo. If the engine repo is made private, the data repo's build fails at the "check out engine repo" step (repository not found) and the site stops updating — including the rebuilds triggered by scan data pushes. Two fixes: keep the engine repo public (simplest), or store a read-only token for the engine repo in the data repo's Secrets and use it for that checkout.