技术文档

大约五分钟即可在本地跑起这个 boilerplate，然后按需启用真正需要的集成。每个集成都可以选择性开启 — 应用默认在禁用支付、没有任何外部 API key 的状态下启动。

项目使用 T3 Env （ @t3-oss/env-core ）做类型安全校验：

应用以单个 Worker（ src/server.ts ）的形式部署到 Cloudflare Workers ，同时承载 API 和 SSR 前端，静态资源一并上传。一条命令即可构建并发布：

认证基于 Better Auth (https://www.better-auth.com/) 构建。服务端使用 D1（Drizzle），并通过 Mail 模块完成邮箱验证和密码重置。客户端使用 better-auth/react 的 createAuthClient ，通过 tanstackStartCookies …

通过 provider 模式 支持订阅和一次性支付。Stripe 和 Creem 是 托管结账网关 （主路径）：将 VITE_PAYMENT_PROVIDER 设为 'stripe' 或 'creem' 以启用其一；设为 '' （空，默认值）则完全禁用支付。两者实现同一个 PaymentProvider 接口，因此下游…

事务性邮件（验证、密码重置、联系表单、订阅欢迎）。 Resend 和 Cloudflare Email Service 是内置 provider。设计上允许通过 provider 注册表添加其他 provider，无需改动调用方。

storage 模块通过 Worker 的 bucket 绑定使用 Cloudflare R2 提供文件上传（和可选的删除）。storage 不需要任何环境变量（项目环境变量总览见 Env (./env.md)）。不使用 S3 SDK 或第三方存储库 — 只用 Cloudflare R2 Workers API (ht…

数据库使用 Drizzle ORM + Cloudflare D1 （SQLite）。D1 通过 wrangler.jsonc 中的 bindings 配置，而非环境变量（项目环境变量总览见 Env (./env.md)）。表定义分布在两个文件中： auth.schema.ts （Better Auth，可由脚本重新生…

模板内置两个可互换的 CAPTCHA 后端，共享同一个验证入口：

端到端的 AI playground，展示如何在 TanStack Start + Cloudflare Workers 应用中集成 Cloudflare Workers AI 和 fal.ai 。所有 demo 均以 TanStack server function（ createServerFn ）形式运行，调用纯…

本项目使用 Paraglide JS 提供运行时多语言支持。

邮件订阅 / 退订 / 状态查询，由 Resend 或 Beehiiv 驱动。通过 websiteConfig.newsletter 配置；环境变量来自 serverEnv （ src/env/server.ts ）。变量列表及设置位置见 Env (./env.md)。

主要受众： 在 Cloudflare Workers 上构建 SaaS 产品的独立开发者和 solo founder。他们是技术娴熟的开发者，看重速度、效率和干净的工具链。他们用这个 boilerplate 跳过搭建环节，更快交付能产生收入的产品。他们的场景是专注的效率工作 — 希望无摩擦地配置、定制并部署。

推荐本框架，即可从你带来的每一笔付费订阅中持续赚取佣金。

FastSaas 是一个完全运行在 Cloudflare Workers 运行时之上的全栈 React 应用。一个代码库同时承载营销站点、登录后的产品、管理后台和 API 层。