Skip to content
Source
Sign inSign up
TanStack/cli
Open History to see the last commit

troubleshooting.md

117 lines2.1 KB

Installation

Command not found

# Use npx instead
npx @tanstack/cli create my-app

# Or reinstall globally
npm install -g @tanstack/cli

Permission denied

Use a Node version manager:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20

Node too old

Requires Node.js 18+:

node --version  # Check
nvm install 20  # Upgrade

Project Creation

Directory exists

tanstack create my-app-v2              # Different name
tanstack create my-app --target-dir ./new/path  # Different path
tanstack create my-app -f              # Force overwrite

Add-on fetch failed

Check internet. Or use local:

git clone https://github.com/TanStack/cli.git
cd cli && pnpm install && pnpm build
node packages/cli/dist/index.js create my-app

Conflicting add-ons

Some add-ons conflict with each other (e.g., multiple ORMs, multiple auth providers). Use --addon-details <id> to see what conflicts with what:

tanstack create --addon-details clerk

Runtime

Missing env vars

cp .env.example .env
# Edit .env with your values
pnpm dev  # Restart

Tailwind not working

Check .tanstack.json has "tailwind": true and styles.css imports @import 'tailwindcss'.

MCP Server

Claude Desktop not connecting

  1. Config location:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Config format:

    {
      "mcpServers": {
        "tanstack": {
          "command": "npx",
          "args": ["@tanstack/cli", "mcp"]
        }
      }
    }
  3. Restart Claude Desktop completely

SSE mode

tanstack mcp --sse
# Connects at http://localhost:8080/sse

Getting Help

Include when reporting:

  • npx @tanstack/cli --version
  • node --version
  • OS and package manager
  • Full error message

Links: