用途:提供从 Next.js App Router 迁移到 TanStack Start 的分步检查清单,按顺序完成各项任务。
主要能力:给出概念映射表(如 app/page.tsx 对应 src/routes/index.tsx、Server Actions 对应 createServerFn、middleware.ts 对应 src/start.ts 等),并分步说明 Vite 配置、路由工厂、布局转根路由、页面转文件路由、Server Actions 转 Server Functions、数据获取、API 路由转 Server Routes、导航、中间件与元数据/SEO 的转换方式,附迁移后检查项与常见错误。
必要用法:先建迁移分支 git checkout -b migrate-to-tanstack-start,安装 npm i @tanstack/react-start @tanstack/react-router 与 npm i -D vite @vitejs/plugin-react,卸载 npm uninstall next @next/font @next/image。注意 TanStack Start 默认同构,所有代码在两端运行,服务端逻辑须用 createServerFn;不使用 "use server"/"use client" 指令;类型完全推断,不要强制转换或标注。
适用场景:已有 Next.js App Router 项目、计划迁移到 TanStack Start 的开发者。
限制:资料为迁移清单,未提供收费、平台支持范围或迁移耗时等信息。