tanstack-query

Installation
Summary

Server state management for React with TanStack Query v5, covering data fetching, mutations, infinite queries, and offline support.

  • Requires object syntax for all hooks (useQuery({ queryKey, queryFn })) and array query keys; v4 function overloads are removed
  • Includes useMutationState for cross-component mutation tracking, simplified optimistic updates via variables, and throwOnError for error boundaries
  • Supports offline-first patterns via networkMode ('online', 'always', 'offlineFirst') and PWA scenarios with fetchStatus detection
  • Provides infiniteQueryOptions factory and maxPages for memory-efficient pagination; initialPageParam is now required
  • Prevents 16+ migration errors: renamed options (gcTime replaces cacheTime, isPending replaces isLoading), removed query callbacks (use useEffect instead), and SSR/hydration race conditions with streaming components
SKILL.md

TanStack Query (React Query) v5

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)


v5 New Features

useMutationState - Cross-Component Mutation Tracking

Access mutation state from anywhere without prop drilling:

import { useMutationState } from '@tanstack/react-query'

function GlobalLoadingIndicator() {
  // Get all pending mutations
Related skills
Installs
2.5K
GitHub Stars
776
First Seen
Jan 20, 2026