tanstack-start
Installation
SKILL.md
TanStack Start
Use this skill when the work touches TanStack Start or @tanstack/react-start.
Workflow
- Identify the app's current Start shape before changing code:
- Package versions for
@tanstack/react-start,@tanstack/react-router, build plugins, React, and optional@tanstack/react-query. - Build tool: Vite or Rsbuild.
- Start entrypoints:
src/router.tsx,src/routes/__root.tsx, generatedrouteTree.gen.ts, optionalsrc/start.ts, and optional customsrc/server.ts. - Route files under
src/routes, especially loaders,server.handlers, middleware, and auth boundaries.
- Package versions for
- Refresh current docs when the task depends on latest behavior, deployment adapters, security defaults, RC/experimental APIs, or a version mismatch. Start from source-map.md.
- For new apps or routing/setup work, use setup-routing.md.
- When adding, moving, or reviewing page/layout UI, hooks, or helpers under
src/routes, follow route-colocation.md. Prefer folder +index.tsxfor every page; keep route-only UI in-components/-hooks/-lib; put reusable feature code insrc/modules/<feature>/. - For data loading, server functions, server routes, middleware, env boundaries, auth, and execution-model issues, use server-data.md.
- For deployment, production modes, prerendering, ISR, SPA mode, selective SSR, custom server entrypoints, and verification, use deployment-production.md.