欢迎使用 Raypx
基于 TanStack Start、oRPC 和 Drizzle ORM 构建的现代全栈 SaaS 起手架。
Raypx 是一个生产级 SaaS 起手架模板，为你提供构建真实产品所需的一切——而不是又一个 Todo 应用。
TanStack Start
基于 Vite 8 的服务端渲染与文件路由
类型安全 API
oRPC + Zod 实现端到端类型安全
内置认证
邮箱密码 + Google & GitHub OAuth 开箱即用
国际化
支持英文和中文，基于路径前缀的路由
Docker 就绪
多阶段 Dockerfile，可直接用于生产部署
Monorepo
11 个内部包，由 Turborepo 统一管理
技术栈
| 层级 | 技术 |
|---|---|
| 框架 | TanStack Start + Nitro + Vite 8 |
| 数据库 | PostgreSQL + Drizzle ORM |
| 认证 | Better Auth（邮箱 + OAuth） |
| API | oRPC + Zod |
| UI | React 19 + Tailwind CSS 4 + shadcn/ui |
| 文档 | Fumadocs |
| 国际化 | use-intl（en-US, zh-CN） |
| 邮件 | Resend + React Email |
| 工具链 | Biome + Lefthook + Turborepo |
快速开始
git clone https://github.com/raypx/raypx-tanstack.git
cd raypx-tanstack
cp .env.example .env # 填写必要的环境变量
pnpm install
pnpm run db:push # 推送 Schema 到 PostgreSQL
pnpm dev # 启动开发服务器 http://localhost:3001阅读快速开始指南了解详细的配置步骤。
为什么选择 Raypx？
市面上不乏全栈模板，但大多数存在以下问题：
- 过度依赖 Next.js——难以自定义底层运行时
- 缺少真实的认证系统——只有最基础的登录逻辑
- 没有生产部署方案——本地跑得通，上不了线
Raypx 采用了不同的思路：
- TanStack Start——基于 Vite 8 构建的全栈框架，底层由 Nitro 驱动，支持 SSR、SSG 和纯客户端渲染
- Better Auth——功能完备的认证方案，支持邮箱密码、Google OAuth、GitHub OAuth、双因素认证等
- oRPC——类型安全的 RPC 框架，与 Zod 深度集成，提供端到端的类型推导
- Drizzle ORM——轻量且类型安全的 ORM，支持迁移管理和关系查询
- 完整的 Monorepo——11 个内部包由 Turborepo 管理，清晰的模块边界