复制成新产品
从 GitHub 开新项目,并保留拉取模板更新的通道。
建仓库
模板在自己账号下时没法 fork 给自己,一个账号也只能有同一仓库的一个 fork,开多个产品不够用。所以用“克隆 + 新建仓库”,把模板留作 upstream:
git clone git@github.com:tyrad/nuxt-starter.git my-app
cd my-app
git remote rename origin upstream
gh repo create my-app --private --source . --push
模板以后有更新:
git fetch upstream
git merge upstream/main
如果新产品放在 GitHub 组织下,也可以直接在网页上 Fork 到组织,用 Sync fork 同步。
本地初始化
npm install
npm run auth:setup:local
npm run db:migrate:local
npm run dev
要改的文件
package.json、wrangler.jsonc:项目名、Worker 名、库名site.config.ts:站点名、正式 Worker 名、域名、D1 ID(先改这个)app/app.config.ts:导航shared/locales.ts、i18n/locales/:语言和文案,见多语言app/assets/css/main.css:品牌色app/pages/index.vue:首页介绍app/pages/privacy.vue、terms.vue:按实际收集的数据重写shared/site-pages.ts:sitemap 收录的页面;新页面在这里登记,内容定稿后写上lastmod,以后正文有实质修改再更新。文档按content/docs自动收录,删掉文档页就不列。见 robots 与 sitemapcontent/docs/:文档
尽量只改这些位置,业务代码放新文件,合并模板更新时冲突少。
要新建的
- Cloudflare:新的 D1、Worker 和域名
- Google Cloud:新项目、同意屏幕、OAuth 客户端
- Resend:新的发件域名、Key、两份模板
- 新的
NUXT_AUTH_SECRET,每个站点、每个环境各一份 - 支付:每个产品单独一个商户账号,不要和别的站共用。渠道见支付
可选统计
为新产品创建独立的 GA4 媒体资源/Web 数据流与 Clarity 项目,在构建前配置 NUXT_PUBLIC_GA4_ID、NUXT_PUBLIC_CLARITY_PROJECT_ID,不沿用其他产品的 ID。留空关闭,开发默认不加载;修改后重新构建发布。
GA4 后台关闭 Enhanced measurement,由模板手工记录页面切换;Clarity 开启 Consent Mode。访客同意后才加载统计,账号/支付与含参数入口默认排除,UTM 落地也暂时跳过。完整创建、配置和验收见GA4 与 Clarity。