Never miss a release that matters
AI-powered summaries of every GitHub release.
AI Summaries
Changelogs condensed into clear, actionable insights.
Always Free
Track up to 5 packages at no cost, forever.
Weekly Digest
A curated summary of every release, delivered weekly.
TL;DR
TanStack Query and its integrations across frameworks have been updated to replace the deprecated isServer property with environmentManager.isServer(), improving server-side rendering (SSR) compatibility.
Breaking
- Replace usages of
isServerwithenvironmentManager.isServer()(determines if code is running on the server). This change impacts Next.js, React Query, Vue Query, and Angular Query integrations.
Fixes Worth Knowing
- Improved detection of custom query hooks within the ESLint plugin (code analysis tool).
- Fixed an issue in the query devtools (debugging interface) where missing query row state could cause errors.
TL;DR
This release improves the stability of the React Query Devtools by preventing crashes when query state is temporarily unavailable and when query keys change.
Breaking
- Next.js Integration: The
isServerproperty is deprecated in@tanstack/react-query-next-experimental. UseenvironmentManager.isServer()instead. - Vue Integration: The
isServerproperty is deprecated in@tanstack/vue-query. UseenvironmentManager.isServer()instead.
New
- ESLint Plugin: The
@tanstack/eslint-plugin-querynow flags rest destructuring on custom hooks returning Query results, improving code maintainability (requires typed linting).
Fixes Worth Knowing
- React Query Devtools no longer crashes when a cached query state is temporarily unavailable.
- React Query Devtools now correctly identifies queries even when their keys are mutated.
TL;DR
This release updates TanStack Query and its related integrations (Svelte and Vue) to version 5.101.0, bringing dependency updates and under-the-hood improvements to the core query engine.
Fixes Worth Knowing
- Devtools now correctly display query status for all integrations.
- Resolved an issue where certain edge cases could cause stale data to be displayed.
TL;DR
Lit Query now avoids unnecessary re-renders when using function-backed query options, improving performance in Lit (JavaScript UI library) applications.
Fixes Worth Knowing
Redundant Lit component updates are resolved for query options, mutation state, and query results, leading to better application responsiveness.
TL;DR
TanStack Query and its related SolidJS integrations have been updated to improve compatibility with the latest vite-plugin-solid version.
New
No new features were introduced in this release.
Fixes Worth Knowing
No fixes impacting typical usage were included in this release.
Before You Upgrade
If you are using vite-plugin-solid, ensure you upgrade to the next.5 version for optimal compatibility.
TL;DR
TanStack Query now supports passing mutationOptions for more control over mutation behavior (server state management).
New
- Mutation options are now supported, enabling finer-grained control over how mutations are handled within TanStack Query.
Fixes Worth Knowing
- No specific fixes impacting typical usage in this release.
TL;DR
TanStack Query v5 introduces editable query data in the Devtools (developer tools) for easier debugging and data manipulation.
Breaking
None.
New
- Editable Devtools Data: Directly modify query data within the Devtools for improved debugging.
- Typed Query Keys: Query keys are now strongly typed, enhancing type safety.
- Vue Query Enhancements:
useQuerynow supports getter functions for theenabledoption, offering more dynamic control.
Fixes Worth Knowing
- Improved type inference for
useQueriesanduseSuspenseQuery. - Fixed issues with Vue Query suspense and Solid Query reconciliation.
- Resolved type errors in
useQueryfor Vue.
Before You Upgrade
No specific upgrade steps are required.
TL;DR
TanStack Query’s DevTools now include improved accessibility with screenreader text for offline mock buttons and the DevTools open icon.
Breaking
None.
New
None.
Fixes Worth Knowing
- DevTools now provides screenreader support for key interactive elements, improving accessibility.
- Production builds now include the DevTools, resolving a previous issue.
- Improved build sizes for UMD (Universal Module Definition - a JavaScript module format) builds.
Before You Upgrade
None.
TL;DR
TanStack Query now correctly clears timers and intervals, preventing potential memory leaks when queries unmount or refetch.
Fixes Worth Knowing
Fixed a bug where timers and intervals weren’t always cleared when queries unmounted or refetched, which could lead to memory leaks.
Before You Upgrade
No action is needed to upgrade. This release includes a bug fix and should be transparent.
TL;DR
TanStack Query now offers experimental local storage persistence, allowing the query cache to survive page reloads and potentially improve app performance.
Breaking
- Types: Type definitions have been adjusted to improve type inference when using the object syntax for query options. (TypeScript users - check your configurations.)
New
- Local Storage Persistence: An experimental
persist-localstoragefeature allows caching query data in the browser’s local storage. (Browser storage - for offline-like behavior.) - Integrated Devtools: The developer tools are now included directly within the core TanStack Query package. (Debugging tools - easier installation.)
Fixes Worth Knowing
isFetchednow correctly reports status for failed fetches.- Queries are refetched when
resetQueriesis called. - Improved serialization for server-side rendering (SSR).
Before You Upgrade
- If using TypeScript, review your query option types after upgrading to ensure correct inference with the object syntax.
TL;DR
TanStack Query now correctly infers types when using object syntax for query options, improving developer experience.
Fixes Worth Knowing
Type inference for query options (data fetching configurations) using object syntax has been corrected. This resolves issues where TypeScript (a JavaScript language extension) wasn’t accurately recognizing the types you provided.
Before You Upgrade
No action is needed; this is a bug fix and should work seamlessly.
TL;DR
TanStack Query now supports bi-directional infinite scrolling and provides more granular control over mutations with separate mutate and mutateAsync functions, improving data management in complex applications.
Breaking
mutatefunction split intomutateandmutateAsync(requires code updates to mutation calls).
New
- Infinite Queries: Added support for bi-directional infinite scrolling (allows loading data in both directions).
- Mutation Control: Separated
mutateintomutate(synchronous) andmutateAsync(asynchronous) for finer-grained control. - Fetching Status: New
useIsFetchinghook andisFetchingfilter for more precise component rendering based on query state.
Fixes Worth Knowing
- Improved handling of query cancellation, ensuring data reverts to the previous state.
- Fixed issues with refetching on infinite queries after page deletion.
- Resolved problems with overriding default options and optimistic updates.
Before You Upgrade
- Update all calls to
mutateto eithermutateormutateAsyncdepending on your needs.
TL;DR
TanStack Query now correctly handles updating query data for queries that haven't fully initialized, preventing unexpected behavior with asynchronous data.
Fixes Worth Knowing
setQueryData now resolves promises correctly when used with uninitialized queries, fixing a bug that could cause infinite loading states.
Before You Upgrade
No action is needed; this is a bug fix release.