SuperAPI AI 工具集

tanstack-start-netlify-to-vercel

通用与其它

查看项目

更新于 10-16 03:39

技能介绍

用途:把运行在 Netlify 上的 TanStack Start 应用迁移到 Vercel。应用代码(路由、组件、服务端函数)基本不变,改动集中在 Vite 与构建配置、删除 Netlify 配置、以及调用 Netlify 平台原语的代码。

主要能力:用 Nitro Vite 插件(nitro/vite)替换 @netlify/vite-plugin-tanstack-start,删除 netlify.toml,把构建脚本改为 vite dev / vite build;将 Netlify Blobs 文件存储映射到 Vercel Blob、键值数据映射到 Redis 或 Edge Config、Netlify DB 映射到 Postgres、Scheduled Functions 映射到 Vercel Cron Jobs、Background Functions 映射到 Vercel Queues、Image CDN 映射到 Vercel Image Optimization。

使用方式:先运行 bash scripts/audit.sh /path/to/project 审计现有 Netlify 配置与 @netlify/ 导入,再按步骤执行:npm i nitro 并修改 vite.config.ts;删除 netlify.toml 并卸载 Netlify 包;更新 package.json 脚本;替换存储调用并安装对应 SDK(如 npm i @vercel/blob);迁移环境变量(vercel env add、vercel link、vercel env pull);用 nitro.config.ts 配置定时任务与队列;最后通过 Git 或 vercel CLI 部署。

适用场景:已有可运行的 Netlify 版 TanStack Start 应用、Node.js 20+、拥有 Vercel 账号并安装 Vercel CLI。

限制:不适用于其他框架、全新应用或反向迁移;创建 Vercel 账号、连接存储、填写环境变量与密钥、部署需用户手动完成,技能不接触密钥值;独立 API 处理需放在 routes/api/ 下,Nitro 的 /api 约定在 Vercel 会返回 404;Netlify Forms 无直接对应方案。