Issue with deprecated create-tsrouter-app when using Vite + TanStack Router

[codingdud]

Hi community,

I recently tried to set up a new React project using Vite and TanStack Router. I followed some tutorials and ran:

npm create vite@latest
Warning: create-tsrouter-app is deprecated. Use "tanstack create --router-only" or "npx @tanstack/cli create --router-only" instead.
See: https://tanstack.com/router/latest/docs/framework/react/quick-start

My problem :
I am not sure how to properly integrate TanStack Router with a Vite project after this deprecation.
Should I start a new project using npx @tanstack/cli create --router-only instead of Vite, or can I still use Vite and add TanStack Router manually?
I would appreciate guidance or examples for setting up a new project that works with the latest TanStack Router.
if it vite problem there is scope of improvement

Thanks in advance! 🙏

[sunnypatell]

this has actually been fixed as of today. here's what happened:

the backstory

when vite first added tanstack router as a template option (PR #19573, march 2025), create-vite delegated to npm create tsrouter-app@latest under the hood.

meanwhile, tanstack consolidated all their CLI scaffolding tools into a single package: @tanstack/cli. the old create-tsrouter-app repo was literally renamed to TanStack/cli, and the npm package was turned into a thin deprecation wrapper that just prints the warning and forwards to @tanstack/cli.

so when you ran npm create vite@latest and picked react + tanstack router, vite was still calling the old deprecated package, which triggered the warning.

the fix

vite fixed this in PR #21527 (merged feb 2, 2026). the customCommand was updated from:

// old
'npm create -- tsrouter-app@latest TARGET_DIR --framework react --interactive'

// new
'npm exec @tanstack/cli@latest -- create TARGET_DIR --template file-router --interactive'

this shipped in create-vite@8.3.0 (released feb 9, 2026). so if you update to the latest create-vite, the warning goes away.

what to do now

option 1: just update create-vite and try again

npm create vite@latest

(if you're on the latest npm, it'll pull create-vite@8.3.0+ which has the fix)

option 2: skip create-vite entirely and use the tanstack CLI directly

# router-only SPA (vite, no SSR)
npx @tanstack/cli create my-app --router-only

# full tanstack start app (with SSR)
npx @tanstack/cli create my-app

the --router-only flag is probably what you want if you just want a vite SPA with file-based routing and no SSR.

quick reference for @tanstack/cli

command	what it does
npx @tanstack/cli create my-app	full-stack tanstack start app (SSR)
npx @tanstack/cli create my-app --router-only	client-only SPA with vite
npx @tanstack/cli create my-app --add-ons clerk,drizzle	with add-ons
npx @tanstack/cli add clerk drizzle	add features to existing project
npx @tanstack/cli create --list-add-ons	see all available add-ons

links

• fix PR (vitejs/vite#21527)
• create-vite@8.3.0 release
• tanstack CLI repo
• tanstack CLI docs
• tanstack router quick start