tanstack-query

TanStack Query

Server-state guidance for queries, mutations, caching, optimistic updates, SSR, persistence, testing, and all official adapters.

Start with release-matched adapter documentation. Query Intent draft guidance is preserved separately and must be checked against the installed version.

Workflow

1. Inspect installed TanStack packages and exact versions.
2. Open the installed adapter’s index or a common task below. Use draft task guides as supplementary guidance after checking their APIs against the release-matched adapter.
3. Topic references are indexes. Choose one guide or section for the task; follow its prerequisite links only when needed.
4. Prefer installed package types and version-matched source guidance over memory.
5. Preserve headless/core behavior when translating examples to a framework adapter.

Task routing

• React adapter — Release-matched React setup, queries, and reactivity.
• Preact adapter — Release-matched Preact setup, queries, and reactivity.
• Vue adapter — Release-matched Vue setup, queries, and reactivity.
• Solid adapter — Release-matched Solid setup, queries, and reactivity.
• Svelte adapter — Release-matched Svelte setup, queries, and reactivity.
• Angular adapter — Release-matched Angular setup, queries, and reactivity.
• Lit adapter — Release-matched Lit setup, queries, and reactivity.
• Foundations — Client setup, keys, options, fetching, defaults, and abstractions.
• Mutations and cache updates — Mutations, invalidation, cancellation, and optimistic updates.
• Data shaping — Pagination, infinite queries, placeholders, selectors, and render efficiency.
• Frameworks and UI state — Adapter reactivity, status, errors, suspense, and devtools.
• Routing and SSR — Router composition, prefetching, hydration, and streaming.
• Offline and integrations — Persistence, broadcast, realtime, and form integration.
• Quality and migration — Lint rules, tests, and major-version migration.

Common tasks

• React: optimistic updates and rollback
• Vue: refetch when reactive inputs change

Framework routing

• React — detect @tanstack/react-query. Read React adapter.
• Preact — detect @tanstack/preact-query. Read Preact adapter.
• Vue — detect @tanstack/vue-query. Read Vue adapter.
• Solid — detect @tanstack/solid-query. Read Solid adapter.
• Svelte — detect @tanstack/svelte-query. Read Svelte adapter.
• Angular — detect @tanstack/angular-query-experimental. Read Angular adapter.
• Lit — detect @tanstack/lit-query. Read Lit adapter.

Adapter versions are listed on their guides. In particular, Svelte and Lit may use different major versions from Query Core. Draft task examples are not evidence that an API exists in another adapter.

Product boundaries

Use these separate product skills when the task crosses their boundary: tanstack-router, tanstack-start, tanstack-form.

Source status

Official documentation from TanStack/query, matched to these verified release inputs: @tanstack/angular-query-experimental@5.104.2, @tanstack/lit-query@0.2.27, @tanstack/preact-query@5.104.2, @tanstack/query-core@5.104.2, @tanstack/react-query@5.104.2, @tanstack/solid-query@5.104.2, @tanstack/svelte-query@6.3.2, @tanstack/vue-query@5.104.2.

See source provenance for exact upstream inputs and deduplication records.