v2.14.1 docs header polish: the docs-center search trigger is now a prominent search field right next to the brand — placeholder text, ⌘K hint, icon-only on narrow screens.
AnvilWiki
Esc Close · ↵ Search
Powered by Pagefind
中文

Development Manual

For customizers and contributors: the change map, categories & locales, theme & homepage copy, feature switches, CI & security, syncing upstream or contributing back, and running ops through AI (GSC API setup, anvilwiki-ops CLI + MCP).

9 lessons

  1. 1 Read the Map First: What to Change, What to Leave Alone Three layers — code (rarely touched), config (once per game), content (daily). The decision tree locates any change in 30 seconds, plus six Astro 5 gotchas.
  2. 2 Add Categories and Add Languages Step-by-step recipes for adding a navigation category (three-place consistency) and adding a language (scaffold plus translation prompts). A lookup manual.
  3. 3 The Feature-Toggle Table: Ads, Comments, Analytics All optional features share one toggle mechanism — empty variable = nothing rendered. The full variable table, where they go, and the advanced wrangler.toml route.
  4. 4 Verify Your Changes: The Checklist and the Gates The post-change, pre-commit checklist: seven local commands, the eight CI gates, the three pipelines, and the safety and performance baselines.
  5. 5 Sync Upstream: Bringing Official Updates In Three commands to merge official updates, the conflict mantra, and the semver promises that decide whether you upgrade.
  6. 6 Contribute Back: Returning the Good Parts Five steps to contribute to AnvilWiki (issue first, branch, self-verify, PR, tests and docs), plus PR-ing your own site onto the official showcase wall.
  7. 7 Run Ops with AI: GSC setup, metrics & MCP GSC API setup in five minutes (Google Group relay), CF token into .env, then doctor, metrics and evidence-ranked insights — with MCP, every write lands as a PR.
  8. 8 The Content Pipeline: Keyword CSV to Draft PR Paste a keyword CSV into Actions; the pipeline builds drafts, runs all eight gates, and opens a draft PR only on all-green. No AI keys in CI; a human merges.
  9. 9 Multi-Site Management: One Toolkit, N Sites From site two: register in sites.toml (credentials never enter), inspect with one command via --all and --site; submit refuses --all. AI referrals read as trends.