SuperAPI AI 工具集

bun-tanstack-start

通用与其它

查看项目

更新于 10-15 21:05

技能介绍

用途:在 Bun 运行时上运行 TanStack Start 全栈 React 框架,适合使用 TanStack Router、服务器函数、vinxi 的项目,以及处理 SSR、构建、preset 等常见错误。

主要能力:提供项目脚手架、开发/构建/预览脚本;基于文件的路由(根布局、静态路由、动态路由如 $userId、API 路由);路由 loader 数据加载;使用 createServerFn 定义服务器函数(可读取请求上下文、做会话校验);API 文件路由(createAPIFileRoute 的 GET/POST);search params 校验(如用 zod);错误处理与 pending 组件。示例中还用 bun:sqlite 访问数据库。

使用方式:

  • 创建项目:bunx create-tanstack-start@latest my-app
  • 安装依赖:bun install
  • 开发:bun run dev;构建:bun run build;预览:bun run start
  • 脚本通常为 vinxi dev / vinxi build / vinxi start,并在 app.config.ts 中设置 server.preset: "bun"
  • 部署可用 NITRO_PRESET=bun bun run build 后执行 bun .output/server/index.mjs,也提供 Docker 示例

限制与注意:脚手架会下载并执行远程代码,资料建议遵循供应链安全实践,例如 Bun 默认禁用 post-install 脚本、通过 package.json 的 trustedDependencies 放行特定包、在 bunfig.toml 配置 minimumReleaseAge 冷却期,并使用 socket 工具审计;常见错误包括未设 bun preset 导致找不到 bun:sqlite、路由文件位置错误、服务器函数网络错误、水合不匹配等。更高级的路由、表单与乐观更新内容在参考文档中,资料未展开具体细节。