Usage

CLI Reference

tanstack create

Create a new TanStack application. By default creates a TanStack Start app with SSR.

sh
tanstack create [project-name] [options]
OptionDescription
--add-ons <ids>Comma-separated add-on IDs
--template <url-or-id>Template URL/path or built-in template ID
--package-manager <pm>npm, pnpm, yarn, bun, deno
--framework <name>React, Solid
--router-onlyCreate file-based Router-only app without TanStack Start (add-ons/deployment/template disabled)
--toolchain <id>Toolchain add-on (use --list-add-ons to see options)
--deployment <id>Deployment add-on (use --list-add-ons to see options)
--examples / --no-examplesInclude or exclude demo/example pages
--tailwind / --no-tailwindDeprecated compatibility flags; accepted but ignored (Tailwind is always enabled)
--no-gitSkip git init
--no-installSkip dependency install
-y, --yesUse defaults, skip prompts
--interactiveForce interactive mode
--target-dir <path>Custom output directory
-f, --forceOverwrite existing directory
--list-add-onsList all available add-ons
--addon-details <id>Show details for specific add-on
--jsonOutput machine-readable JSON for automation
--add-on-config <json>JSON string with add-on options
sh
# Examples
tanstack create my-app -y
tanstack create my-app --add-ons clerk,drizzle,tanstack-query
tanstack create my-app --router-only --toolchain eslint --no-examples
tanstack create my-app --template https://example.com/template.json
tanstack create my-app --template ecommerce
tanstack create --list-add-ons --framework React --json
tanstack create --addon-details drizzle --framework React --json

tanstack add

Add add-ons to an existing project.

sh
tanstack add [add-on...] [options]
OptionDescription
--forcedForce add-on installation even if conflicts exist
sh
# Examples
tanstack add clerk drizzle
tanstack add tanstack-query,tanstack-form

Visual setup is available at https://tanstack.com/builder.


tanstack add-on

Create and manage custom add-ons.

init

Extract add-on from current project:

sh
tanstack add-on init

Creates .add-on/ folder with info.json and assets/.

compile

Rebuild after changes:

sh
tanstack add-on compile

See Creating Add-ons for full guide.


tanstack template

Create reusable project templates.

init

sh
tanstack template init

Creates template-info.json and template.json.

compile

sh
tanstack template compile

See Templates for full guide.

tanstack libraries

List TanStack libraries with optional group filtering.

sh
tanstack libraries [options]
OptionDescription
--group <group>Filter by group: state, headlessUI, performance, tooling
--jsonOutput machine-readable JSON
sh
tanstack libraries
tanstack libraries --group state --json

tanstack doc

Fetch a TanStack documentation page by library and path.

sh
tanstack doc <library> <path> [options]
OptionDescription
--docs-version <version>Docs version (default: latest)
--jsonOutput machine-readable JSON
sh
tanstack doc router framework/react/guide/data-loading
tanstack doc query framework/react/overview --docs-version v5 --json

tanstack search-docs

Search TanStack documentation.

sh
tanstack search-docs <query> [options]
OptionDescription
--library <id>Filter by library ID
--framework <name>Filter by framework
--limit <n>Max results (default 10, max 50)
--jsonOutput machine-readable JSON
sh
tanstack search-docs "server functions" --library start
tanstack search-docs loaders --library router --framework react --json

tanstack ecosystem

List ecosystem partner recommendations.

sh
tanstack ecosystem [options]
OptionDescription
--category <category>Filter by category
--library <id>Filter by TanStack library
--jsonOutput machine-readable JSON
sh
tanstack ecosystem --category database
tanstack ecosystem --library router --json

tanstack pin-versions

Pin TanStack package versions to avoid conflicts.

sh
tanstack pin-versions

Removes ^ from version ranges for TanStack packages and adds any missing peer dependencies.


Configuration

Projects include .tanstack.json:

json
{
  "version": 1,
  "projectName": "my-app",
  "framework": "react",
  "mode": "file-router",
  "typescript": true,
  "tailwind": true,
  "packageManager": "pnpm",
  "chosenAddOns": ["tanstack-query", "clerk"]
}

Used by add-on init and template init to detect changes.