tanstack-query-best-practices

TanStack Query best practices for optimized data fetching, caching, mutations, and server state management in React. 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. - Covers 32 rules across 10 categories: query keys, caching strategies, mutations, error handling, prefetching, infinite queries, SSR integration, parallel queries, performance optimization, and offline support - Each rule includes explanation, anti-patterns, recommended implementations, and contextual guidance for when to apply - Prioritized by impact: critical rules prevent cache bugs and data inconsistencies; high-priority rules ensure data integrity and UI consistency - Organized with hierarchical query key factories, targeted cache invalidation, optimistic updates with rollback context, and structural sharing patterns - 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...