tanstack-query

TanStack Query is an async state manager, not a data fetching library. You provide a queryFn that returns a Promise; React Query handles caching, deduplication, background updates, and stale data management.

When to use: Infinite scrolling, offline-first apps, auto-refetching on focus/reconnect, complex cache invalidation, React Native, hybrid server/client apps.

When NOT to use: Purely synchronous state (useState/Zustand), normalized GraphQL caching (Apollo/urql), server-components-only apps (native fetch), simple fetch-and-display (server components).

TanStack React 用の Query v5 サーバー状態管理。クエリ/ミューテーション パターン、v4 から v5 への移行 (オブジェクト構文、gcTime、isPending、keepPreviousData)、useMutationState によるオプティミスティック更新、HydrationBoundary による SSR/ハイドレーション、無限クエリ、オフライン/PWA サポート、throwOnError によるエラー境界、および React 19 Suspense 統合をカバーします。 データのフェッチの構築、移行エラーの修正、ハイドレーションの不一致のデバッグ、キャッシュ戦略の実装、またはミューテーションの構成を行うときに使用します。 ソース: oakoss/agent-skills。