TanStack Query Skill

When to use

• Introducing a new query/mutation.

• Debugging cache invalidation, stale data, or SSR hydration.

Workflow checklist

• Design a stable query key (include stable identifiers; avoid objects unless serialized).

• Co-locate query logic with the owning domain.

• Ensure SSR/hydration correctness (use Router + Query SSR integration patterns).

• Set cache semantics intentionally (staleTime/gcTime) and invalidate on writes.

• 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.