cli
TanStack官方CLI,用于快速创建和管理全栈应用。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:cli。 它的用途是:TanStack官方CLI,用于快速创建和管理全栈应用。 详细介绍见:https://321skill.com/skills/cli-tanstack/ 请根据该页面的说明完成安装。
使用示例
“我需要启动一个新的全栈项目,使用React和SSR,并集成身份验证和数据库。”,它会建议你使用命令 `npx @tanstack/cli create my-app --add-ons clerk,drizzle` 来一键创建项目并配置好 Clerk 和 Drizzle。或者,当你
对AI说:“帮我看看TanStack Router的最新文档里关于加载器的内容。”,它可以利用CLI的搜索功能,执行 `npx @tanstack/cli search-docs "loaders" --library router --framework react --json` 来获取结构化的信息。
介绍
TanStack CLI 是 TanStack 生态系统的官方命令行工具,旨在解决开发者快速搭建和配置现代化 Web 应用项目的繁琐问题。它通过预设的脚手架和丰富的插件(Add-ons)系统,将项目初始化、依赖集成和配置工作自动化,显著提升开发效率。
使用方式非常直接,主要通过 npx @tanstack/cli create 命令即可启动项目创建向导。开发者可以选择创建基于 TanStack Start 的完整全栈 SSR 应用,或仅包含 TanStack Router 的单页应用(SPA)。工具还支持通过 --add-ons 参数一键集成身份验证(如 Clerk)、数据库(如 Drizzle)、状态管理(如 TanStack Query)等常用功能模块。
这个工具非常适合希望快速启动新项目,或为现有项目集成 TanStack 生态库的 Web 开发者。无论是个人项目原型开发,还是团队需要统一的技术栈和项目结构,TanStack CLI 都能提供标准化的起点。
使用建议是,对于新项目,可以先使用 --blank 参数创建一个最简应用以了解基础结构,再逐步添加所需功能。需要注意的是,CLI 默认会收集匿名遥测数据以帮助改进,但在 CI 环境或设置相应环境变量时会自动禁用,用户也可以通过 tanstack telemetry 命令手动管理此设置。
核心特点
与通用项目脚手架(如 create-react-app)相比,它深度集成并优化了 TanStack 全家桶(Router, Start, Query等)的开发体验,提供开箱即用的类型安全路由和全栈 SSR 支持。其独特的“Add-ons”系统允许以声明式命令一键集成复杂的第三方服务(如认证、数据库),并提供了对 AI Agent 友好的 JSON 输出模式,便于自动化工具集成。
注意事项
主要面向 TanStack 技术栈(React生态),不适合需要其他前端框架(如 Vue、Svelte)或非 Node.js 后端技术的项目。
常见问题
如何创建一个只包含路由的单页应用(SPA)?
使用命令 `npx @tanstack/cli create my-app --router-only`,即可创建一个仅包含 TanStack Router 的 SPA 项目,不包含 SSR 服务端渲染。
如何查看所有可用的插件(Add-ons)?
运行 `npx @tanstack/cli create --list-add-ons` 命令,可以列出所有支持一键集成的插件,如 Clerk、Drizzle、TanStack Query 等。