FlareStarter 文档
FlareStarter —— TanStack Start + Cloudflare Workers 边缘原生 SaaS 起手模板的文档。
欢迎来到 FlareStarter 文档 —— 基于 TanStack Start + Cloudflare Workers 的 全栈、边缘原生 SaaS 起手模板。Clone 下来,在它之上构建你自己的产品。
这套文档本身也是模板的一部分:它内嵌在同一个 app 里,是 /docs 路由下的一个
Fumadocs 站点,内容源文件在 src/content/docs/,随主站
同一个 Worker 一起部署(并非独立 app、也没有独立 Worker)。你可以把这些内容整体
替换成自己产品的文档,也可以继续用它记录你的 fork。想改文档本身,见
编写文档。
入门
第一次拿到代码，按这个顺序走：
- 本地安装与启动 —— clone、配置、本地跑起来
- 环境变量 —— .dev.vars 必填项指引
- 项目架构 —— TanStack Start + Features 结构解析
- 部署到 Cloudflare —— 建资源、配 secrets、上线
- 迁移与种子 —— D1 数据库迁移流程
功能与集成
构建产品时天天会碰的功能切片：
- 数据库 —— D1 与 Drizzle ORM 的增删改查
- 认证 —— better-auth、社交登录、会话
- 计费与订阅 —— Stripe 订阅/终身买断、webhook、扣款失败处理
- 邮件 —— Resend 发信、本地控制台兜底、模板
- Storage (R2) —— 对象存储 / 文件上传
- Waitlist(候补名单) —— 收集邮箱、CSV 导出、bot 防护
- 基础 Admin —— 运营后台与角色
- 国际化与 SEO —— 语言路由与 SEO origin
- 定时任务 —— 自动执行清理和通知
- UI 组件 —— 基础组件库与 Tailwind v4
平台与运维
部署到 Cloudflare 之后才需要关心的平台适配与生产加固:
- Cloudflare 踩坑 —— workerd 已知坑与 Cron
- 安全加固 —— 响应头、环境校验、限流、Turnstile
- 可观测性 —— Cloudflare Web Analytics + Sentry
定制
把模板改成你自己的产品: