> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 一套 TanStack Start SaaS 起步套件，完整产品，跑在 Vite 上

supastack 提供完整的 TanStack Start 应用：类型安全路由、服务端函数、认证、计费、AI 与管理后台，与 Next.js 版本相同的 SaaS，位于同一 monorepo。

_发布于 2026-11-01._
_更新于 2026-11-01._

> **supastack 的 TanStack Start 应用包含什么？**
> 取决于所选方案，但每份许可证都交付运行在 Vite 与 TanStack Router 上的完整 supastack 产品：类型安全的文件式路由与 SSR、服务端函数、认证、工作区、覆盖八家支付提供商的计费、AI 助手，以及带 OpenAPI 参考的管理后台。它与 Next.js 应用读取同一个 Schema 与同一批包，两个 Web 前端可以跑在同一个后端上。

## 完整的 SaaS，而非一角

大多数 TanStack 起步模板止步于登录页和待办列表。我们渲染的是 supastack 的完整界面，与 Next.js 应用提供的同一套页面，所以选择 TanStack Start 绝不意味着接受缩水的产品。

- 首页仪表盘、数据分析与全站搜索
- 成员、邀请、安全会话与 SSO 设置
- 计费：结账、套餐与签名 Webhook，覆盖八家支付提供商
- AI 助手与后台代理任务，支持工作区级预算
- 内置 OpenAPI 文档与在应用内打开的 API 参考页
- 引导、通知、邮件预览与反馈收件箱
- 13 种语言与 20+ 主题包，共享同一设计系统


## 团队选择 TanStack Start 的理由

Vite 8 秒级启动，TanStack Router 提供端到端类型安全的文件式路由，服务端函数让数据变更紧挨调用它的代码。这是现代 React 栈，却没有框架锁定。

两个 Web 应用共享同一批包，认证、数据库、计费、AI、任务、邮件，功能在两个端同步落地，你的产品逻辑永不分叉。

- TanStack Start + React
- TanStack Start + Vite
- 类型安全的文件式路由与 SSR
- TypeScript + Turborepo
- Better Auth
- Drizzle + PostgreSQL
- Sentry + PostHog


## 两套 Web 栈，一个后端

因为团队偏好 Vite 与 TanStack 生态而选择 TanStack Start，或者两个 Web 应用一起发。它们读取同一个 Schema 与同一批包，一次开发的功能在两个前端上都能用。

每份许可证都包含两个 Web 应用外加 Expo 与 Tauri。只想要这一个栈也有单平台方案。


## 从克隆到上线

一次安装，把应用指向共享数据库，Vite 开发服务器几分钟内就会带着种子数据跑起来。生产构建开箱即可作为 Node 服务器运行，其他部署目标可走 Nitro 预设。

- 同一 monorepo、同一批包，一次安装覆盖所有应用
- 类型安全路由让产品做大后的重构依旧可靠
- 指南与 Next.js 版本一一对应，学习曲线保持平坦


## 常见问题

- TanStack Start 应用功能完整吗？, 完整。它渲染与 Next.js 应用相同的产品面，首页、数据分析、成员、安全会话、计费、设置与 OpenAPI 参考页，并经过同样的测试。
- 该选 Next.js 还是 TanStack Start？, 选团队更喜欢的框架，反正两个都会得到。我们的对比文章详细拆解了取舍。
- 它和 Next.js 应用共用数据库吗？, 是的。两个 Web 应用通过同一批包读取同一个 Schema，你可以让单个或两个前端都跑在同一个后端上。
