tanstack-query-best-practices

Installation
Summary

TanStack Query best practices for optimized data fetching, caching, mutations, and server state management in React.

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

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.

When to Apply

  • 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

Rule Categories by Priority

Related skills
Installs
5.7K
GitHub Stars
163
First Seen
Jan 20, 2026