Nuxt Starter

复制成新产品

从 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 与 sitemap
  • content/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。