FlareStarter 文档
FlareStarter —— TanStack Start + Cloudflare Workers 边缘原生 SaaS 起手模板的文档。
欢迎来到 FlareStarter 文档 —— 基于 TanStack Start + Cloudflare Workers 的 全栈、边缘原生 SaaS 起手模板。Clone 下来,在它之上构建你自己的产品。本文档同时覆盖 开源版与 Pro 商业版 的功能切片(组织/座位计费/API Keys/Credits/AI/增长/安全包等)。
这套文档本身也是模板的一部分:它内嵌在同一个 app 里,是 /docs 路由下的一个
Fumadocs 站点,内容源文件在 src/content/docs/,随主站
同一个 Worker 一起部署(并非独立 app、也没有独立 Worker)。你可以把这些内容整体
替换成自己产品的文档,也可以继续用它记录你的 fork。想改文档本身,见
编写文档。
入门
第一次拿到代码，按这个顺序走：
- License 与代码交付 —— 买断后获取仓库访问权、分配席位
- 本地安装与启动 —— clone、配置、本地跑起来
- 环境变量 —— .dev.vars 必填项指引
- 项目架构 —— TanStack Start + Features 结构解析
- 部署到 Cloudflare —— 建资源、配 secrets、上线
- 迁移与种子 —— D1 数据库迁移流程
功能与集成
构建产品时天天会碰的功能切片：
- 数据库 —— D1 与 Drizzle ORM 的增删改查
- 认证 —— better-auth、社交登录、两步验证、会话
- 组织与团队 —— organization 插件、RBAC、座位订阅
- 计费与订阅 —— Stripe 订阅/终身买断、webhook、扣款失败处理
- API Keys 与限流 —— org 级签发、KV 滑动窗口、用量聚合
- Credits 用量计费 —— 余额 + 流水、幂等入账、防并发超扣
- AI 对话脚手架 —— Workers AI 流式聊天，按条计费
- 增长 —— 推荐有礼、折扣码、生命周期邮件
- Blog —— MDX 即内容、RSS/JSON-LD、构建期 OG 图
- 邮件 —— Resend 发信、本地控制台兜底、模板
- Storage (R2) —— 对象存储 / 文件上传
- Waitlist(候补名单) —— 收集邮箱、CSV 导出、bot 防护
- 基础 Admin —— 运营后台与角色
- 安全包 —— 审计日志、两步验证、代登录
- 国际化与 SEO —— 语言路由与 SEO origin
- 定时任务 —— 每日对账兜底与自定义任务
- UI 组件 —— 基础组件库与 Tailwind v4
平台与运维
部署到 Cloudflare 之后才需要关心的平台适配与生产加固:
- Cloudflare 踩坑 —— workerd 已知坑与 Cron
- 安全加固 —— 响应头、环境校验、限流、Turnstile
- 可观测性 —— Cloudflare Web Analytics + Sentry
定制
把模板改成你自己的产品: