React Starter Kit：从数据库到前端的全栈 SaaS 模板

react-starter-kit 在 GitHub 上已经拿到 23.6K Star 了。

这是一个全栈 monorepo 模板，用 React 19、tRPC 和 Cloudflare Workers 搭建 SaaS 应用。从数据库到 UI 全链路类型安全，部署到边缘节点几分钟搞定。

1、这玩意儿是干嘛的

一件事：给你一套开箱即用的 SaaS 脚手架。

注册登录、组织管理、订阅付费、API 接口、前端页面，全都在一个仓库里，类型定义从数据库一路穿透到前端组件。不用再东拼西凑各种库，不用再手动对齐前后端类型。

2、技术栈长什么样

运行时用 Bun，不再依赖 Node.js 和 npm。前端是 React 19 配合 TanStack Router 做文件路由，状态管理用 Jotai，样式用 Tailwind CSS v4 和 shadcn/ui。后端是 Hono 加 tRPC，认证走 Better Auth，支持邮箱验证码、Passkey、Google 登录，Stripe 订阅付费也接好了。数据库用 Drizzle ORM 操作 Neon PostgreSQL，schema 定义、迁移、种子数据一套齐全。

整个项目分四个应用：web 是 Astro 做的营销站，负责静态页面和路由分发；app 是主应用 SPA，跑 TanStack Router 和 Jotai；api 是 Hono 加 tRPC 的接口服务，处理认证和业务逻辑；email 是 React Email 写的邮件模板。它们各自独立部署到 Cloudflare Workers，通过 service bindings 互相调用，不走公网。

工具链也配好了：Vite 做构建，Vitest 跑测试，ESLint 和 Prettier 管代码规范，连 VS Code 的配置都预设了。

3、怎么跑起来

装 Bun（v1.3 以上），从模板生成仓库，克隆到本地，bun install 装依赖。复制 .env 为 .env.local，把占位符换成真实的数据库连接串和密钥，bun dev 就能把 web、app、api 三个应用同时启动起来。

数据库初始化用 bun db:push 直接推 schema，bun db:seed 灌测试数据，bun db:studio 打开可视化界面查看表结构。开发阶段用 push 就行，生产环境建议用 bun db:migrate 走正式迁移流程。

部署到 Cloudflare Workers 之前，需要把 BETTER_AUTH_SECRET、Stripe 密钥、OAuth 凭证、邮件服务 Key 等通过 wrangler secret put 写进去。然后依次构建 email、web、app，再逐个 deploy。

4、Monorepo 结构

项目根目录下，apps 放四个应用，packages 放共享组件：ui 是 shadcn/ui 的组件库，core 是通用类型和工具函数，ws-protocol 是 WebSocket 的类型安全通信协议。db 目录放 Drizzle 的 schema 和迁移文件，infra 放 Terraform 配置管 Cloudflare 的基础设施，docs 是 VitePress 写的文档站。

每个应用独立部署，互不影响。web worker 负责路由分发，把 /api/* 请求转给 api worker，把应用路由转给 app worker。

5、适合谁用

想从零搭 SaaS 产品的人。注册、登录、组织管理、付费订阅这些通用功能不用再写一遍，直接在模板上改业务逻辑就行。

对类型安全有要求的团队。tRPC 让前后端共享类型定义，改了后端接口字段，前端编译时立刻报错，不用等运行时才发现问题。

打算部署到边缘节点的项目。Cloudflare Workers 的 service bindings 让几个服务之间调用延迟很低，数据不用绕远路。

ers 的 service bindings 让几个服务之间调用延迟很低，数据不用绕远路。