tanstack-query-best-practices

Comprehensive guidelines for implementing TanStack Query (React Query) patterns in React applications. These rules optimize data fetching, caching, mutations, and server state synchronization. Each rule file in the rules/ directory contains: See individual rule files in rules/ directory for detailed guidance and code examples. - Creating new data fetching logic - Setting up query configurations - Implementing mutations and optimistic updates - Configuring caching strategies - Integrating with SSR/SSG - Refactoring existing data fetching code - qk-array-structure — Always use arrays for query keys - qk-include-dependencies — Include all variables the query depends on - qk-hierarchical-organization — Organize keys hierarchically (entity → id → filters) - qk-factory-pattern — Use query key factories for complex applications - qk-serializable — Ensure all key parts are JSON-serializable - cache-stale-time — Set appropriate staleTime based on data volatility - cache-gc-time — Configure gcTime for inactive query retention - cache-defaults — Set sensible defaults at QueryClient level - cache-invalidation — Use targeted invalidation over broad patterns - cache-placeholder-vs-initial — Understand placeholder vs initial data differences - mut-invalidate-queries — Always invalidate related queries after mutations - mut-optimistic-updates — Implement optimistic updates for responsive UI -...