TanStack Query Skill

When to use

• Introducing a new query/mutation.
• Debugging cache invalidation, stale data, or SSR hydration.

Workflow checklist

1. Design a stable query key (include stable identifiers; avoid objects unless serialized).
2. Co-locate query logic with the owning domain.
3. Ensure SSR/hydration correctness (use Router + Query SSR integration patterns).
4. Set cache semantics intentionally (staleTime/gcTime) and invalidate on writes.
5. Keep devtools disabled in production.

SSR troubleshooting

• Identify which data must be available at SSR time vs client-only.
• Ensure query keys and inputs match across SSR and client hydration.
• Confirm provider wiring and dehydration/rehydration flow stays intact.

Tooling

• Use TanStack MCP for Query APIs, SSR patterns, and cache guidance.