一键部署

StoreCay Starter 是 GitHub 私有仓库。购买许可后你会收到 协作者邀请。邀请只代表你能看源码 — 并不能让 Cloudflare 的公开 Deploy 按钮生效。

为什么 Deploy 按钮会失败

把 starter 地址贴进 deploy.workers.cloudflare.com 会出现：

Repository not found. Are you sure it’s public?

这是预期行为。Cloudflare 的 Deploy to Cloudflare 按钮 只能克隆公开的 GitHub/GitLab 仓库。即使你已被邀请为协作者，Cloudflare 仍按「公开 clone」去拉这个 URL。

请 不要 使用：

https://deploy.workers.cloudflare.com/?url=https://github.com/caydock/store-cay-starter

（任何私有 starter 地址都会同样失败）

买家应走的流程

付费私有模版最接近「一键部署」的做法：

1. 在 storecay.com 购买。
2. 接受私有 starter 的 GitHub 邀请。
3. Fork（或从模版新建仓库）到你自己的 GitHub 账号，可以继续保持私有。
4. 打开 Cloudflare 控制台 → Workers & Pages → Create → Import a repository。连接 GitHub，选择你的 fork。
5. Workers Builds 会读 wrangler.jsonc，可开通 D1 / R2，并部署到你的账号。

控制台「导入仓库」走的是你账号上的 GitHub App，因此 私有 fork 可用。绿色 Deploy 按钮不行。

首次部署之后

1. 配置密钥：

npx wrangler secret put SESSION_SECRET
npx wrangler secret put GUEST_TOKEN_SECRET
# 可选：支付 / 邮件
npx wrangler secret put STRIPE_SECRET_KEY
npx wrangler secret put STRIPE_WEBHOOK_SECRET
npx wrangler secret put PAYPAL_CLIENT_SECRET
npx wrangler secret put RESEND_API_KEY

2. 如需迁移：

npx wrangler d1 migrations apply DB --remote

3. 从你的 fork 本地克隆后播种管理员：

npx tsx scripts/seed-admin.ts you@example.com 'your-password' "Your Name"

4. 编辑 store.config.ts（站点 URL、品牌、功能开关）。
5. 将 Stripe webhook 指到 https://<你的域名>/api/stripe/webhook。

从本地克隆用 CLI 部署见 Cloudflare 托管。环境变量：环境变量。支付：店铺支付。