TanStack Start Skill
When to use
- Creating or refactoring routes under
src/routes/*. - Implementing server functions (privileged reads/writes).
- Ensuring SSR + hydration correctness with TanStack Query.
Guardrails
- Keep secrets and privileged writes server-side only.
- Validate inputs at boundaries with Zod (params/search/server-function inputs).
- Prefer “thin routes”: UI composition + data wiring; move business logic into domain modules.
Workflow checklist
- Identify route + data boundary (client vs server) and decide what must run server-side.
- Define Zod schema(s) for inputs/params; parse early; return typed results.
- Use SSR-friendly loading patterns (route-level loader + SSR Query integration).
- Keep cache behavior explicit (staleTime, gcTime, invalidation) and predictable.
- Add minimal tests for critical logic when behavior changes.
Tooling
- Use TanStack MCP for Start APIs, server function patterns, and SSR guidance.