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

troubleshooting.md

104 lines2.1 KB

1---
2id: troubleshooting
3title: Troubleshooting
4---
5​
6## Installation
7​
8### Command not found
9​
10```bash
11# Use npx instead
12npx @tanstack/cli create my-app
13​
14# Or reinstall globally
15npm install -g @tanstack/cli
16```
17​
18### Permission denied
19​
20Use a Node version manager:
21​
22```bash
23curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
24nvm install 20
25```
26​
27### Node too old
28​
29Requires Node.js 18+:
30​
31```bash
32node --version # Check
33nvm install 20 # Upgrade
34```
35​
36## Project Creation
37​
38### Directory exists
39​
40```bash
41tanstack create my-app-v2 # Different name
42tanstack create my-app --target-dir ./new/path # Different path
43tanstack create my-app -f # Force overwrite
44```
45​
46### Add-on fetch failed
47​
48Check internet. Or use local:
49​
50```bash
51git clone https://github.com/TanStack/cli.git
52cd cli && pnpm install && pnpm build
53node packages/cli/dist/index.js create my-app
54```
55​
56### Conflicting add-ons
57​
58Some add-ons conflict with each other (e.g., multiple ORMs, multiple auth providers). Use `--addon-details <id>` to see what conflicts with what:
59​
60```bash
61tanstack create --addon-details clerk
62```
63​
64## Runtime
65​
66### Missing env vars
67​
68```bash
69cp .env.example .env
70# Edit .env with your values
71pnpm dev # Restart
72```
73​
74### Tailwind not working
75​
76Check `.tanstack.json` has `"tailwind": true` and `styles.css` imports `@import 'tailwindcss'`.
77​
78## MCP Server Removal
79​
80`tanstack mcp` has been removed from the CLI. Use the CLI introspection commands instead:
81​
82```bash
83tanstack create --list-add-ons --json
84tanstack create --addon-details clerk --json
85tanstack libraries --json
86tanstack search-docs "server functions" --library start --json
87tanstack ecosystem --category database --json
88```
89​
90If you need MCP in your generated app, keep using the `mcp` add-on during app creation.
91​
92See [MCP Migration](./mcp-migration.md) for command-by-command replacements.
93​
94## Getting Help
95​
96Include when reporting:
97- `npx @tanstack/cli --version`
98- `node --version`
99- OS and package manager
100- Full error message
101​
102Links:
103- [GitHub Issues](https://github.com/TanStack/cli/issues)
104- [Discord](https://tlinz.com/discord)