tanstack-query

Last Updated : 2026-01-20 Versions : @tanstack/react-query@5.90.19, @tanstack/react-query-devtools@5.91.2 Requires : React 18.0+ (useSyncExternalStore), TypeScript 4.7+ (recommended) Access mutation state from anywhere without prop drilling: New pattern using variables - no cache manipulation, no rollback needed: Renamed from useErrorBoundary (breaking change): Control behavior when offline: Detecting paused state: Combine results from parallel queries: Type-safe factory for infinite queries (parallel to queryOptions ): Limit pages stored in cache for infinite queries: Note: maxPages requires bi-directional pagination ( getNextPageParam AND getPreviousPageParam ). ✅ Use object syntax for all hooks ✅ Use array query keys ✅ Configure staleTime appropriately ✅ Use isPending for initial loading state ✅ Throw errors in queryFn ✅ Invalidate queries after mutations ✅ Use queryOptions factory for reusable patterns ✅ Use gcTime (not cacheTime) ❌ Never use v4 array/function syntax ❌ Never use query callbacks (onSuccess, onError, onSettled in queries) ❌ Never use deprecated options ❌ Never assume isLoading means "no data yet" ❌ Never forget initialPageParam for infinite queries ❌ Never use enabled with useSuspenseQuery ❌ Never rely on refetchOnMount: false for errored queries This skill prevents 16 documented issues from v5 migration, SSR/hydration bugs, and common mistakes: Error :...