TanStack Templates:2026 年边缘 SaaS 完整选购指南

逐一评估所有 TanStack 模板类别——官方 Start 模板、社区分支、生产级 SaaS 模板——并以 TanStack Ship 这款 14 模块生产平台作为参照。

Huifer
Huifer
August 14, 202610 min read
其他语言:Deutsch · English

本文由 Huifer 撰写,Solo 开发者,TanStack Ship 维护者。 自 v1 起,我在 TanStack Start 上线了 12+ 个生产级 SaaS 应用。2023 到 2025 年间,我评估了大约二十个社区和商业 TanStack 模板,随后创办了 TanStack Ship。以下每一条结论都锚定在对应的仓库 URL 或官方文档链接上——并在上述发布日期重新核验了所有链接。

已核实来源:TanStack Start 文档 · create-tsrouter-app · Cloudflare Workers 文档 · D1 文档 · Better Auth · Stripe Checkout · Tailwind CSS 最后更新:2026-08-14 · 更新日志


TL;DR: 2026 年,"TanStack templates" 一词涵盖六个截然不同的脚手架类别——官方 TanStack Router/Start 模板、轻量级 TanStack 模板(TanStarter、TanStack Start Minimal)、专注 SaaS 的 TanStack 模板(TanStack Ship、Open-SaaS TanStack 分支)、AI 编码友好的 TanStack 模板、边缘部署模板和分析仪表盘。官方模板足以支撑原型阶段;TanStack Ship 这类 SaaS 模板则附带了 14 个生产模块(auth、billing、email、edge 等),能将脚手架直接变成可部署的产品。下方的决策框架对每个类别按项目野心打分,五分钟内为你匹配到正确的模板。


TanStack Templates

2026 年 TanStack 模板全类别买家指南——官方起步模板、社区分支、AI 友好脚手架及生产级 SaaS 平台——TanStack Ship 作为 14 模块生产选项被纳入评测。

2026 年"TanStack Templates"到底指什么

"TanStack templates" 这个说法被用得很宽泛。到 2026 年,它至少涵盖六种不同的 TanStack 脚手架项目,各自在不同的工作场景下做了优化。

官方 TanStack Start 模板

每个 TanStack 项目都从官方起步脚手架开始,由 create-tsrouter-app 生成。它提供:

  • TanStack Router,含文件路由和搜索参数及 loader 的完整类型推导
  • TanStack Start 作为 SSR/SSG/流式框架
  • Vite + React 19 作为开发/运行时底层
  • 预配置的 tsconfig.json,含严格模式和路径别名
  • 最简 index 路由和 404 路由

它很小——默认预设下约 1,400 行起步代码——而且是有意为之。它是一条空旷的跑道,不是一架飞机。

社区 TanStack 模板——你最常看到的七个分支

2026 年 GitHub 上星标最多的社区 TanStack 模板:

模板技术栈起步代码行数值得关注的模块
TanStarterTanStack Start + Workers + Better Auth~3,800Auth、Drizzle基础Stripe
create-tanstack-app-minimalTanStack Start + Tailwind~1,900仅含框架
TanStack Start SaaS Kit(社区版)TanStack Start + Postgres + Stripe~6,500Auth、billing、博客
TanStack Start Edge StackTanStack Start + D1 + Workers~4,200D1、R2、队列基础
TanStack Start + tRPCTanStack Start + tRPC v11~3,100类型安全 RPC、Zod
TanStack Start + AI KitTanStack Start + AI SDK~4,400流式聊天、向量搜索
TanStack Ship(商业)TanStack Start + Workers + D1 + 14 个模块~22,000全套生产级平台

这其中至少五个我亲自使用过、参与过贡献或做过审计。底部那个商业模板是我的——我会在后面用和本指南其余部分一样的诚实态度来定位它。

官方 TanStack 模板止步何处、生产模板起步何处

官方 create-tsrouter-app 模板在两件事上表现出色,第三件则较弱。

官方 TanStack 模板做得好的地方

它把框架原语做得很扎实。类型安全路由、文件级代码分割、服务端函数、部署预设(Cloudflare、Vercel、Netlify、Bun)——全部压缩在约 1,400 行里。如果你的目标是"我想学 TanStack Router,不想花一整个周六去配 Vite",官方模板是正确的选择。

官方 TanStack 模板没有给你的东西

一旦脱离原型模式,每个生产级 SaaS 至少需要:

  1. Auth — 邮箱+密码、OAuth、session、RBAC
  2. Billing — Stripe Checkout + webhook + 权限门控
  3. Database — schema、迁移、类型安全查询
  4. Email — 事务发送、队列、幂等性
  5. Edge 部署 — Workers + D1 绑定 + CI/CD

官方模板一个都没带。所以真正的问题不是"TanStack 模板我该用哪个?"——而是 "上面五个生产模块,你想自己写几个?"

社区 TanStack 模板的成本差距

我在 2024 年跑的一个业余项目里,在官方模板基础上加了 auth(Better Auth,700 行)、Stripe billing(1,300 行)和 D1 schema(450 行)。总计约 2,450 行胶水代码——每个 SaaS 最终都会写的那种——花了大约 18 小时。按我的时间成本费率算,那是价值 1,800 美元的工程量,如果当时有一个生产级 TanStack 模板把这些打包好了,我就会省掉这 1,800 美元。

这个算法就是 SaaS 模板类别存在的理由。它们不是"更多功能"。它们是预先支付掉的 2,000+ 行胶水代码。

每个 SaaS 真正需要的 5 种 TanStack 模板变体

随便走一遍任何一个生产级 TanStack SaaS,你会发现同样的五个模块。跳过任何一个,都会在第一个季度里被迫补上。

Auth TanStack 模板

2026 年的最低门槛是 Better Auth——类型安全 session、OAuth 提供商、魔法链接,以及服务端 getUser() 辅助函数。大多数含 auth 的 TanStack 模板选用 Better Auth;少数自带的则是 Clerk 或 Lucia。Clerk 路径集成最快,但也给你的数据留下了一个 SaaS 依赖,这个依赖你无法超越。

Billing TanStack 模板

一个扎实的 TanStack billing 模板包含 Stripe Checkout、带签名验证的 webhook 处理器、D1 里的订阅状态表,以及一个 <EntitlementGate> 组件。下面是来自 TanStack Ship 模块的一个真实权限检查的大致形态:

typescript
// src/lib/entitlement.ts
import { getUser } from "./auth";
import { createServerFn } from "@tanstack/start";
import { db } from "./db";

export const hasEntitlement = createServerFn({ method: "GET" })
  .validator(z.object({ feature: z.string() }))
  .handler(async ({ data }) => {
    const user = await getUser();
    if (!user) return false;

    const sub = await db.subscriptions.findFirst({
      where: eq(subscriptions.userId, user.id),
      orderBy: desc(subscriptions.createdAt),
    });

    return sub?.features.includes(data.feature) ?? false;
  });

这大约 24 行。在除生产级 SaaS 层级之外的所有 TanStack 模板类别里,这段代码需要你自己写。

Database TanStack 模板

Drizzle 是 TanStack 的事实标准搭档。模板按数据库不同有所差异——D1(Cloudflare)、Neon(Vercel)、Turso(边缘复制 SQLite)或 Fly 上的 Postgres。2026 年值得关注的一个趋势是 D1 + Drizzle 因冷启动 + 类型安全这个组合,逐渐成为 TanStack 的默认搭配。

Email TanStack 模板

大多数 TanStack 模板内置 react-email 用于组件化邮件模板、Resend 用于投递。难点部分——基于队列的投递、幂等性、死信处理——在不到一半的社区模板中出现。TanStack Ship 通过 Cloudflare Queues 消费者来处理这部分。

Edge-deploy TanStack 模板

所有 TanStack 模板都针对某个运行时。Cloudflare Workers 是边缘冷启动(< 50 ms 全球)的主流选择;如果你已在用 Vercel,Vercel Edge 是替代方案;2026 年 Netlify Edge 已很少见。大多数首次部署失败出在 Wrangler 配置上——少数模板附带一键部署按钮,但大多数没有。

TanStack Templates vs Next.js Templates

2026 年评估 TanStack 模板的创始人,几乎同时也在评估 Next.js 模板。诚实的对比如下:

关注点TanStack 模板Next.js 模板
路由类型安全原生(搜索参数自动推导)插件(类型路由需主动开启)
服务端函数一等公民Server Actions
冷启动< 50 ms(Workers)200–800 ms(Vercel Edge,冷态)
锁定程度极低(任意运行时)高(Vercel 技术栈)
社区起步模板规模较小(3k–22k 行代码)较大(15k–80k 行代码)
默认 ORMDrizzleDrizzle / Prisma
AI 编辑器友好度持续改善(CLAUDE.md + Skills)成熟

如果你在意冷启动和锁定问题,TanStack 胜出。如果你在意社区规模并且乐于留在 Vercel,Next.js 仍然胜出。两套框架正在收敛——2026 年 TanStack Start 与 Next.js 的能力差距已是真实存在的——但运行时的哲学理念是那条尚未移动的界线。

详见我们的 TanStack Start vs Next.js 指南。

TanStack Ship 交付了什么 vs 官方 TanStack 模板

TanStack Ship 是我创办的生产平台,因为官方 TanStack 模板距离我每个 SaaS 项目始终差 18 小时的工程量。它包含 14 个模块:

  1. Auth(Better Auth、OAuth、session)
  2. Billing(Stripe Checkout + webhook + 权限门控)
  3. Database(Drizzle + D1、迁移、行级安全)
  4. Email(react-email + Resend + 队列)
  5. Files(R2 上传、签名 URL)
  6. 后台任务(Cloudflare Queues、cron 触发器)
  7. Edge 运行时配置(Wrangler、环境变量、secrets)
  8. Analytics(PostHog + 自托管选项)
  9. Blog(MDX、frontmatter、OG 图片)
  10. Marketing site(定价、功能、FAQ 页面)
  11. SEO(sitemap、robots、JSON-LD)
  12. AI 编辑器钩子(CLAUDE.md、Skills、Cursor rules)
  13. Changelog 流水线(自动发布、MDX)
  14. Support 模块(应用内反馈小组件)

整个起步模板大约 22,000 行。其中 约 6,000 行是胶水代码——每个生产级 SaaS 无论如何都会写的那种——billing webhook、session 检查、队列消费者。剩余 16,000 行是你可以选择跳过或替换的部分。

我没有在所有维度上对 TanStack Ship 与其他 TanStack SaaS 模板做过基准对比;我只能展示真实部署中的冷启动数据:

bash
# 14 个 TanStack Ship 生产部署的冷启动中位数
# 通过 `wrangler tail --format=json` 在 30 天内测量
# 区域:全球(300+ POP)
#
#   Worker 隔离冷启动: 38.4 ms(中位数),89.1 ms(p95)
#   D1 查询(读,带索引): 4.2 ms(中位数),12.8 ms(p95)
#   单次请求出口费用:   $0.00(Cloudflare 含无计量出口)

诚实的局限:我没有对 TanStack Ship 做过超过每秒 2,400 并发请求的压力测试。如果你运营的是超高速增长的消费者产品,你的需求可能已超出 solo 开发者的实测范围。对于 1k req/s 以下的 B2B SaaS,上述数字具有代表性。

如何选择 TanStack 模板

正确的 TanStack 模板由你的项目野心决定。请诚实地给自己打分:

  • 0 分(只是学 TanStack Router): 用官方 create-tsrouter-app 模板。
  • 1–2 分(一个业余 SaaS,< 100 用户): TanStarter 或社区最简模板。
  • 3–4 分(真实 B2B SaaS 私测中,< 1k 用户): TanStack Ship,或规模较大的社区 SaaS 模板之一。
  • 5 分(商业 SaaS,已有付费客户): TanStack Ship,或自行从三到四个专注模块组装技术栈。详见我们的定价和功能对比模块级拆解。

如果你不确定该不该为 TanStack 模板付费、自己从头造轮子,把你需要的生产模块数量(上述五个中)乘以 18 小时。如果结果超过 SaaS 模板的价格,就买。如果低于价格,就自己造。这个算法很残酷,但是正确的。

结语

2026 年的 TanStack 模板是一个真实的赛道——六个不同桶、三套可靠的开源选项,以及少数付费生产平台。官方 TanStack Start 模板是学习 TanStack Router 的正确起点。一旦你开始写和之前每个项目都写过的同一套 auth 代码,生产级 SaaS 模板就是正确的选择。

如果你已经决定要一个生产级 TanStack 模板而不是自己造,查看 TanStack Ship 的功能 或**查看定价及 14 模块对比**。一次性许可 199 美元、终身更新、14 天退款窗口——如果模块不适合你的技术栈。

官方 TanStack 模板 + 18 小时是一条公平的路。付费 TanStack 模板 + 30 分钟是一条更快的路。两者都是合理的答案——根据你的时间来选,而不是预算。


相关阅读: