一个开源的、为 Cloudflare Pages 原生优化的游戏 wiki 站点模板。 让新手零成本免费部署上线，性能好，适配 wiki 游戏站。
An open-source game wiki site template, natively optimized for Cloudflare Pages. Free to deploy, beginner-friendly, fast, and built for game wikis.
|
|
|
|
Lighthouse 4×100 — 实测于 anvilwiki.pages.dev（2026-08-12）
AnvilWiki 是一个游戏 wiki 站点模板——用来快速搭建围绕某款游戏（Roblox、Steam 新游等）的攻略内容站，通过 SEO 获取流量，通过广告变现。
技术栈是 Astro + Cloudflare Pages：纯静态输出、零适配器、免费无限带宽、全球 CDN、零 JS 优先（首屏极快）。
- ⚡ 极快：Astro 零 JS 优先，Lighthouse 全 100（Performance / Accessibility / Best Practices / SEO）
- 🌐 Cloudflare 原生：纯静态输出，零适配器，免费无限带宽
- 🎨 JSON 驱动首页：模块化布局，换游戏只改 JSON 不改组件
- 🌍 多语言按需求发布：语言数量由 Manifest 决定；只有真实译文才生成本地化文章 URL
- 🔍 SEO 工程化：sitemap / JSON-LD / hreflang / robots 全部代码自动生成
- 🎯 广告就绪：内置 Adsterra iframe 隔离方案，填 key 即生效
- 🔄 批量上站工程化：一个
site-manifest.json驱动站点信息、语言、分类、主题与发布页面 - 🆓 完全免费：MIT 协议，Cloudflare Pages 免费部署
- 📝 类型安全：Content Collections + Zod schema，构建时发现字段错误
# 1. Fork 本仓库到你的 GitHub
# 2. 本地克隆 & 安装
git clone https://github.com/PNGTRID/AnvilWiki.git
cd anvilwiki
pnpm install
# 3. 启动开发服务器
pnpm dev
# 访问 http://localhost:4321
# 4. 准备新站 Manifest、MDX、语言 JSON 和素材，再执行发布前检查
pnpm init-site --manifest ./path/to/site-manifest.json --dry-run
pnpm init-site --manifest ./path/to/site-manifest.json
pnpm release-check
# 5. 部署到 Cloudflare Pages
# cloudflare.com → Pages → Create a project → Connect to Git → 选仓库
# 自动识别 Astro，构建命令 pnpm build，输出目录 dist详细部署指南见 docs/deployment.md。
| 文档 | 内容 |
|---|---|
| docs/PRD.md | ⭐ 完整产品设计文档（架构、数据模型、模块设计、路线图） |
| docs/deployment.md | Cloudflare Pages 部署详细指南 |
| docs/skinning.md | 换皮工作流（4 阶段 7 Part 提示词） |
| docs/batch-publishing.md | Manifest 驱动的批量上站流程与发布闸门 |
| docs/content-format.md | MDX 文章格式规范 |
| docs/seo.md | SEO 工程化说明 |
| docs/ads.md | Adsterra 广告接入指南 |
| docs/migration-from-nextjs.md | 从 Next.js 模板迁移指南 |
| 技术 | 用途 |
|---|---|
| Astro 5 | 静态优先框架 |
| Content Collections | 类型安全的内容管理 |
| Tailwind CSS 4 | 原子化样式 |
| Cloudflare Pages | 免费部署 + 无限带宽 |
| pnpm | 包管理 |
AnvilWiki is an open-source game wiki site template designed for building content sites around specific games (Roblox, Steam new releases, etc.), driving traffic via SEO, and monetizing with ads.
Built on Astro + Cloudflare Pages: pure static output, zero adapters, free unlimited bandwidth, global CDN, and zero-JS by default for blazing-fast first paint.
- ⚡ Blazing fast: Astro zero-JS by default, Lighthouse 4×100 (Performance / Accessibility / Best Practices / SEO)
- 🌐 Cloudflare native: Pure static output, zero adapters, free unlimited bandwidth
- 🎨 JSON-driven homepage: 8 modules, swap games by editing JSON only
- 🌍 Demand-led i18n: Locale count comes from the manifest; localized article URLs exist only when translated MDX exists
- 🔍 SEO engineering: sitemap / JSON-LD / hreflang / robots all auto-generated
- 🎯 Ads ready: Built-in Adsterra iframe isolation, just plug in keys
- 🔄 Batch publishing: One manifest drives site metadata, locales, categories, theme, and published pages
- 🆓 Completely free: MIT license, free Cloudflare Pages deployment
- 📝 Type-safe: Content Collections + Zod schema, catch field errors at build time
# 1. Fork this repo to your GitHub
# 2. Clone & install locally
git clone https://github.com/PNGTRID/AnvilWiki.git
cd anvilwiki
pnpm install
# 3. Start dev server
pnpm dev
# Visit http://localhost:4321
# 4. Add the new manifest, MDX, locale JSON, and assets; then run the release gate
pnpm init-site --manifest ./path/to/site-manifest.json --dry-run
pnpm init-site --manifest ./path/to/site-manifest.json
pnpm release-check
# 5. Deploy to Cloudflare Pages
# cloudflare.com → Pages → Create a project → Connect to Git → select repo
# Auto-detects Astro, build command pnpm build, output dir distSee docs/deployment.md for detailed guide.
MIT — free for commercial use.
Status: ✅ Live demo at anvilwiki.pages.dev — Lighthouse 4×100, CI green, fully deployed.
Features shipped: Pagefind offline search · Astro Image (WebP/srcset) · Manifest-driven publishing · Demand-led i18n · SEO (hreflang, JSON-LD, sitemap) · Release validation
状态：✅ anvilwiki.pages.dev 已上线 — Lighthouse 全 100，CI 全绿。