What problem does it solve? Setting up a TanStack Start project involves non-obvious wiring: plugin order in the Vite config, a getRouter() factory, a root route document shell, and a generated route tree that must never be edited. Missteps cause blank pages, missing hydration, or server code leaking into the client bundle, and developers coming from Next.js often apply patterns that do nothing in Start. ## Core Features & Use Cases - Project Scaffolding Guidance: Covers dependency installation, package.json scripts, tsconfig settings, and both Vite and Rsbuild plugin configuration for @tanstack/react-start v1.166.2. - Project Anatomy Reference: Explains the two required hand-written files (src/router.tsx and src/routes/__root.tsx) plus the generated routeTree.gen.ts, including the mandatory HeadContent, Outlet, and Scripts components. - Setup Troubleshooting: Diagnoses common failures such as reversed plugin order, missing <Scripts />, verbatimModuleSyntax leaks, and Next.js pattern misuse, with a symptom-to-cause triage table. - Use Case: You are starting a new full-stack React app with TanStack Start and the dev server renders a blank page. This Skill identifies that the React Vite plugin was placed before tanstackStart() and provides the corrected config plus a complete minimal project template. ## Quick Start Ask the agent to scaffold a minimal TanStack Start project with Vite config, router factory, and root route, then verify the setup against the common mistakes checklist.
