介绍
什么是 TanShip
TanShip 是一个生产级 TanStack Start 模板，用于开发现代 Web 应用。它内置了身份认证、支付、国际化、精美的仪表盘和公共着陆页——全部集成完毕，可直接部署到 Cloudflare Workers。
目标很简单：跳过样板代码。你不用花几周时间配置路由、主题、表单、认证等基础模块，而是从一个功能完整的应用出发，专注于打造产品的独特性。
TanShip 完全免费、开源，所有依赖均来自社区维护的库。
技术栈
一览项目包含的技术：
- React 19 + TanStack Start + Vite — 现代前端框架与基于文件的路由。参见 页面与路由。
- shadcn/ui + Tailwind CSS v4 — 组件原语与原子化样式。参见 组件 和 主题定制器。
- Cloudflare Workers — 无服务器边缘运行时。参见 部署到 Cloudflare。
- D1 + Drizzle ORM — 边缘端类型安全的数据库查询。参见 数据库。
- Better Auth — 支持 OAuth 和密码登录的身份认证。参见 身份认证。
- Creem / Stripe / PayPal — 可切换的支付提供商，支持订阅和一次性购买。参见 支付概览。
- 基于 URL 的中英文国际化 — 无需 cookie 或浏览器检测的语言切换。参见 国际化。
- Resend — 事务邮件投递，覆盖认证、邮件订阅和联系表单。参见 邮件、邮件订阅 和 联系表单。
- Cloudflare Workers AI — 文本生成、摘要和翻译工具。参见 AI。
适用人群
- 想跳过"空白画布"阶段、快速启动 SaaS 产品的开发者。
- 搭建内部工具或后台管理系统的团队。
- 正在评估 TanStack Start + Cloudflare Workers 技术栈的开发者。
- 任何想要一个真实可用的起点、而不是一个 "hello world" 的人。
如何使用本指南
左侧边栏将所有指南分为六组。按顺序阅读效果最佳——每篇文章都建立在前一篇的基础之上。
| 分组 | 学习内容 | 从这篇开始 |
|---|---|---|
| 从这里开始 | 安装、运行和配置项目 | 入门指南 |
| 配置 | 调整应用设置和功能开关 | 应用配置 |
| 部署 | 部署到 Cloudflare Workers | 部署到 Cloudflare |
| 集成 | 数据库、认证、邮件、支付、AI、邮件订阅、联系表单 | 数据库 |
| 自定义 | 页面、组件、主题、导航、国际化、博客、更新日志、SEO | 页面与路由 |
| 代码库 | 架构、TypeScript、格式化、基础组件、测试 | 项目结构 |
准备就绪后，前往 入门指南 开始在本地机器上设置项目。