用途
TANSHIP Template 是一个 TanStack Start SaaS 样板代码(boilerplate)与模板,面向独立开发者和小型团队。它提供一套完整、可部署的代码库,而不是仅有 UI 皮肤。目标是让开发者配置好自己的密钥后,跳过反复的集成工作,直接专注于产品功能本身。
项目主要面向四类人群:独立黑客(无需花数周搭建基础设施即可验证想法)、小型团队(在类型安全、模块清晰的代码库上启动 MVP)、面向全球市场的中国开发者(可自选支付服务商、使用基于 URL 的语言路由、运行在 Cloudflare 全球边缘节点),以及使用 AI 辅助编程的开发者(AGENTS.md 文件为 AI 编码代理提供项目专属上下文和约定)。
主要能力
五大已实现系统
-
身份验证:使用 Better Auth,支持邮箱/密码登录、Google OAuth 和会话管理。注册触发邮件验证,登录通过 Better Auth 的 cookie 处理创建受管会话,所有已认证请求都会校验会话。包含密码哈希、登录失败在数据库层限流、新账户强制邮箱验证,密码重置使用限时一次性令牌。
-
支付:提供 Creem、Stripe 和 PayPal 三种适配器,通过单一提供商开关(环境变量 PAYMENT_PROVIDER)切换。检查、Webhook 和门户路由会绑定到所选提供商。支付状态来自经过签名校验、幂等的 Webhook;订阅会与提供商同步在 active、trialing、past-due、paused 等状态间流转,UI 不自行授予访问权限。由于 PayPal 没有客户门户,内置账单页面可管理订阅(关闭自动续费及恢复处理)。测试密钥和沙箱模式可用。
-
数据库:基于 Cloudflare D1 的 Drizzle ORM,含 18 张现成数据表,覆盖用户、会话、订阅、订单、订阅通讯、联系消息等。迁移可在本地(Miniflare)和远程通过同一 D1 绑定生成并应用。用户上传的资源存放在 Cloudflare R2,作为原生 Worker 绑定,包含头像上传和资源服务路由示例;本地开发用磁盘存储模拟 R2。
-
邮件:使用 Resend 事务邮件模板,通过翻译文件本地化,包括欢迎、验证、密码重置和收据邮件。订阅通讯使用双重确认,以 D1 为事实来源,一次性确认令牌 24 小时过期并以哈希存储,退订有独立的令牌流程。联系我们表单加入 Cloudflare Turnstile 验证,并在 IP 和邮箱两个维度限流。
-
AI 工作流:包含 8 个 AI 模块——摘要、翻译、标语生成、文本转语音、图像描述、两个图像生成视图和图像编辑。核心工作流直接调用 Cloudflare Workers AI 并按应用内积分计量扣费,因此能展示真实执行和真实扣费;其余工具界面被设计为可扩展的演示。完整的积分系统处理计量、限流和跨套餐扣费,每个套餐有演示配额。各模块将逻辑集中在一处,接线新提供商只需替换模块的服务边界调用,页面、计量和 UI 保持工作。
主题与国际化
提供 52 套明暗主题预设,以及可视化定制器,可控制颜色、五档圆角、浅色/深色/系统模式,以及侧边栏、浮动、内嵌侧边栏变体(含可折叠 offcanvas 和图标模式),均通过 CSS 变量驱动。自定义主题按用户持久化并在刷新后重新应用。语言方面,英文 URL 无前缀,URL 是唯一的区域来源,没有语言 cookie、没有浏览器嗅探、不会闪现错误语言;所有可见字符串(含无障碍标签和 SEO 元数据)都来自翻译文件,新增语言是数据变更而非代码重构。另含命令面板和动态 OG 图片。
内容系统
交付包含版本化的更新日志页面和 36 篇指南,覆盖身份验证、支付、数据库、邮件、AI 和部署等,说明项目专属的配置和部署步骤。这些内容随代码库交付,可成为你自己产品的文档中心。
使用方式
购买后通过私有仓库邀请交付完整源代码,采用一次性付费的永久许可,包含邮件支持和未来模板更新。需要配置自己的密钥和提供商(身份验证、支付、邮件、AI 等)。项目原生面向 Cloudflare Workers,D1 和 R2 直接绑定,Workers AI 走原生绑定,Turnstile 用部件密钥加服务器端验证保护表单。指南详细说明了项目专属的配置和部署步骤,本地开发可对同一 D1 数据库运行。
适用场景
- 独立开发者快速验证 SaaS 想法
- 小型团队启动 MVP
- 面向全球市场、需要多种支付选项和 URL 语言路由的构建者
- 希望在 Cloudflare 全球边缘节点部署、避免适配层的项目
限制
项目有意保持聚焦:不包含多租户、RBAC 或管理后台,只提供独立开发者和小型团队发布所需的核心系统。AI 部分中,核çå工作流目前在 Workers AI 上运行,其余工具 UI 是可直接扩展的界面,需接入自己的提供商、凭据和调用。此外,项目描述中提到 750+ 自动化检查,但具体检查项和验证方式在资料中暂未提供。