TanStack Query (React Query) Best Practices

Comprehensive guide for TanStack Query based on TkDodo's authoritative blog posts. TkDodo (Dominik Dorfmeister) is a core maintainer of TanStack Query. Contains patterns across 17 categories covering queries, mutations, caching, TypeScript, testing, and advanced patterns.

When to Apply

Reference these guidelines when:

• Writing new useQuery, useMutation, or useInfiniteQuery hooks
• Structuring query keys for a feature or application
• Implementing optimistic updates or cache synchronization
• Debugging unexpected refetches or stale data issues
• Integrating React Query with TypeScript
• Testing components that use React Query
• Deciding between React Query and other solutions

Rule Categories by Priority