快速开始

0. 把它变成你自己的项目

pnpm run init

初始化脚本会问站点名、短名、域名与支持邮箱，然后：

• 把文案、manifest、package.json 与 wrangler.jsonc 里的品牌名换成你的；
• 按你的选择重设内容模块开关（默认全关，用 --modules docs,blog 打开）；
• 从 .env.example 生成 .env，补上 BETTER_AUTH_SECRET 等空着的键。

一路回车即可得到可运行的结果；--non-interactive 供脚本化场景使用， --dry-run 只打印将要改动的文件。重跑是安全的：已有的 .env 值与品牌不会被再次改写。

模块默认全关是有意的：模板出厂时 mail、analytics 等模块是开的，而它们各自要求 对应的凭据，一个什么都没配的克隆者会卡在生产校验上。按需打开，缺什么补什么。

1. 安装依赖

pnpm install

2. 配置本地资源

pnpm run setup

脚本会问你项目名，然后创建（或复用）D1 数据库与 KV namespace，生成认证密钥， 把结果写进 .env 与 wrangler.jsonc。.env 里已有的值会保留——脚本只改写自己管的那几个键。

R2 不会被自动创建：bucket 需要先在 Cloudflare Dashboard 开通一次（要绑支付方式， API 代劳不了）。手动步骤见 存储。

没有登录 Cloudflare 时脚本会提示，但仍可继续——本地开发用 D1 的 SQLite 模拟， 不需要真实资源。登录方式：

pnpm exec wrangler login

3. 启动

pnpm dev

打开 http://localhost:3000。若数据库没初始化成功，手动跑一次：

pnpm exec wrangler d1 migrations apply DB --local

4. 改站点信息

所有站点信息集中在 src/config/website.ts：

// src/config/website.ts
export function createWebsiteConfig(env: PublicEnv): WebsiteConfig {
  return {
    baseUrl: env.VITE_BASE_URL,
    metadata: {
      name: '<your-site-name>',                // ← 改成你的站点名
      images: { ogImage: '/logo.png', /* … */ },
    },
    docs: { enabled: true },                 // ← 不需要文档站就改 false
    // …
  }
}

完整字段见网站配置。

5. 部署

pnpm deploy

依次执行生产 env 校验 → 构建 → 客户端 bundle 泄漏检查 → wrangler deploy。

本地 .env 不会自动成为生产 secret。部署前需用 wrangler secret put 单独配置， 且不得把 secret 放进 VITE_ 变量——它们会进入浏览器 bundle。

想推送到 main 就自动部署，见 Cloudflare · 自动部署。