简介
EasyStarter 文档入口，快速了解项目结构、核心能力和常用指南
欢迎使用 EasyStarter
EasyStarter 是一个面向 SaaS 场景的现代全栈模板，也是一个标准的 SaaS monorepo。它把 Web 应用、移动端、服务端 API、数据库、认证、支付、邮件、存储和国际化等常见基础设施提前组织在同一个工程里，让你可以把主要精力放在业务本身，而不是反复搭脚手架。
这种 monorepo 结构让 EasyStarter 可以把前端、后端、移动端和共享能力放在同一个工程中统一管理。它的优势是共享代码更直接、跨端协作更顺畅、功能迭代一致性更高，尤其适合 SaaS 场景下常见的认证、支付、订阅、权限和多语言能力复用。
现代化 AI SaaS 模板
在 AI 辅助开发越来越普遍的情况下，monorepo 的价值会更明显。因为 AI 更擅长在一个完整、连续的上下文里理解系统结构，而 monorepo 正好把前端、后端、移动端、共享包和配置集中在同一个代码仓库中。这意味着 AI 更容易看清模块之间的依赖关系，理解一项功能会影响哪些应用和共享逻辑，从而减少只改一端、漏改另一端的问题。对于 SaaS 项目来说，这种优势尤其明显。像认证、支付、订阅、权限、多语言、存储这类能力，通常会同时涉及 Web、Server、Native 和共享配置。放在 monorepo 里，AI 可以更高效地做跨模块检索、重构、补全、批量修改和一致性检查，也更容易保持架构统一和代码风格一致。
如果你希望快速启动一个具备真实商业能力的产品，而不是从零拼接一套技术栈，EasyStarter 的目标就是给你一个足够清晰、足够完整、也足够容易继续演进的基础工程。
默认围绕 SaaS 产品最常见的几层能力展开：
- Web 应用：基于 React 19、TanStack Start 和 shadcn/ui，负责公开页面、认证流程和后台界面
- Server API：基于 Hono 运行在 Cloudflare Workers 上，处理认证、支付、存储和业务接口
- 移动端应用：基于 React Native 和 Expo，复用业务能力并承接移动端场景
- 共享包：把配置、类型、国际化和通用能力沉淀到
packages/*，减少跨端重复实现
这不是一个只包含 UI 的模板，也不是一个只适合演示的 boilerplate。它更接近一个可以继续扩展的 SaaS 基础工程。
项目结构
选择客户端文档
热门指南
核心能力
营销网站
- 基于 shadcn/ui 和 Tailwind CSS 的响应式页面
- 价格和订阅页面预览
- 基于 Fumadocs 的 MDX 文档站与多语言支持
- 深色和浅色主题切换
认证
- 基于 Better Auth 的跨端身份系统
- 默认支持邮箱密码和 OAuth 登录
- 移动端内置 Apple 原生登录支持
支付与账单
- Web：基于 Stripe 的结账和 Webhook 流程
- 移动端：基于 RevenueCat 的内购和权益流转
- 通过
app-config共享价格目录
数据库与 ORM
- 基于 Drizzle ORM 的强类型数据层
- 服务端数据库基于 Cloudflare D1
API 层
国际化
- Web、Server、移动端共享的 i18n 架构
- 通过
@repo/i18n统一管理多语言资源
适合什么项目？
EasyStarter 适合这些场景：
- 你想尽快启动一个 SaaS MVP，但不想从认证、支付、邮件这些基础设施重搭
- 你希望 Web、Server、移动端共享同一套核心业务配置和类型
- 你需要一个可以持续扩展的工程基础
常见问题
EasyStarter 是纯前端模板吗？
不是。EasyStarter 同时包含 Web 前端、Server API、移动端、数据库接入、认证、支付和邮件能力。
EasyStarter 适合直接上线吗？
它的定位是生产可用的基础工程。基础设施已经具备，但你仍然需要补齐业务相关的模型、权限、页面和流程。
下一步
如果你第一次接触这个项目，建议按这个顺序阅读：