Skip to content

Conversation

@manudeli
Copy link
Collaborator

@manudeli manudeli commented Jan 21, 2026

Problem

Now, we have

package version
@tanstack/angular-query-experimental 5.90.23
@tanstack/angular-query-persist-client 5.62.26
@tanstack/eslint-plugin-query 5.91.3
@tanstack/query-async-storage-persister 5.90.21
@tanstack/query-broadcast-client-experimental 5.90.19
@tanstack/query-core 5.90.19
@tanstack/query-devtools 5.92.0
@tanstack/query-persist-client-core 5.91.18
@tanstack/query-sync-storage-persister 5.90.21
@tanstack/react-query 5.90.19
@tanstack/react-query-devtools 5.91.2
@tanstack/react-query-next-experimental 5.91.0
@tanstack/react-query-persist-client 5.90.21
@tanstack/solid-query 5.90.22
@tanstack/solid-query-devtools 5.91.2
@tanstack/solid-query-persist-client 5.90.22
@tanstack/svelte-query 6.0.17
@tanstack/svelte-query-devtools 6.0.3
@tanstack/svelte-query-persist-client 6.0.19
@tanstack/vue-query 5.92.8
@tanstack/vue-query-devtools 6.1.3

TanStack Query packages are now released with different versions across packages (e.g. @tanstack/react-query vs @tanstack/react-query-devtools).
Previously, all packages shared the same version, which made upgrades simple and predictable.

This mismatch of versions introduces unnecessary friction for users.

Previous behavior

Upgrading used to be straightforward:

  • Pick the specific version
  • Apply it consistently across all TanStack Query packages

This minimized cognitive overhead and reduced the risk of incompatibilities.

Current issue

Versions are no longer aligned:

  • Closely related packages can be on different versions
  • Framework adapters and tooling advance independently

As a result, users must manually check version compatibility and make careful upgrade decisions, making routine upgrades more complex and error-prone.

Expectation

  • TanStack Query packages should return to sharing a single version
  • Packages that already diverged in major versions can remain fixed individually

TO-BE

package version
@tanstack/angular-query-experimental 5.92.9
@tanstack/angular-query-persist-client 5.92.9
@tanstack/eslint-plugin-query 5.92.9
@tanstack/query-async-storage-persister 5.92.9
@tanstack/query-broadcast-client-experimental 5.92.9
@tanstack/query-core 5.92.9
@tanstack/query-devtools 5.92.9
@tanstack/query-persist-client-core 5.92.9
@tanstack/query-sync-storage-persister 5.92.9
@tanstack/react-query 5.92.9
@tanstack/react-query-devtools 5.92.9
@tanstack/react-query-next-experimental 5.92.9
@tanstack/react-query-persist-client 5.92.9
@tanstack/solid-query 5.92.9
@tanstack/solid-query-devtools 5.92.9
@tanstack/solid-query-persist-client 5.92.9
@tanstack/svelte-query 6.1.4
@tanstack/svelte-query-devtools 6.1.4
@tanstack/svelte-query-persist-client 6.1.4
@tanstack/vue-query 5.92.9
@tanstack/vue-query-devtools 6.1.4

✅ Checklist

  • I have followed the steps in the Contributing guide.
  • I have tested this code locally with pnpm run test:pr.

🚀 Release Impact

  • This change affects published code, and I have generated a changeset.
  • This change is docs/CI/dev-only (no release).

Summary by CodeRabbit

  • Chores
    • Configured grouped fixed package sets for many @TanStack packages to improve coordinated releases.
    • Applied patch bumps across multiple @TanStack packages to keep them up to date.
    • Removed an unnecessary top-level package version metadata entry.

✏️ Tip: You can customize this high-level summary in your review settings.

@changeset-bot
Copy link

changeset-bot bot commented Jan 21, 2026

🦋 Changeset detected

Latest commit: c728d51

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 21 packages
Name Type
@tanstack/angular-query-experimental Patch
@tanstack/angular-query-persist-client Patch
@tanstack/eslint-plugin-query Patch
@tanstack/query-async-storage-persister Patch
@tanstack/query-broadcast-client-experimental Patch
@tanstack/query-core Patch
@tanstack/query-devtools Patch
@tanstack/query-persist-client-core Patch
@tanstack/query-sync-storage-persister Patch
@tanstack/react-query Patch
@tanstack/react-query-devtools Patch
@tanstack/react-query-next-experimental Patch
@tanstack/react-query-persist-client Patch
@tanstack/solid-query Patch
@tanstack/solid-query-devtools Patch
@tanstack/solid-query-persist-client Patch
@tanstack/svelte-query Patch
@tanstack/svelte-query-devtools Patch
@tanstack/svelte-query-persist-client Patch
@tanstack/vue-query Patch
@tanstack/vue-query-devtools Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@manudeli manudeli self-assigned this Jan 21, 2026
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 21, 2026

📝 Walkthrough

Walkthrough

The changes populate .changeset/config.json "fixed" with two grouped arrays of @tanstack packages, add a new changeset file listing multiple patch bumps, and remove the top-level version field from packages/query-test-utils/package.json.

Changes

Cohort / File(s) Summary
Changeset Configuration
.changeset/config.json
fixed changed from [] to two grouped arrays listing many @tanstack/* packages (core group and Vue/Svelte group)
Release Changeset
.changeset/dry-hotels-grin.md
New changeset adding patch bumps for multiple @tanstack packages and a trailing chore entry
Package Metadata
packages/query-test-utils/package.json
Removed top-level "version": "0.0.0" field

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Suggested labels

package: solid-query-devtools, package: vue-query-devtools, package: eslint-plugin-query, package: svelte-query, package: svelte-query-devtools, package: svelte-query-persist-client, package: angular-query-experimental

Suggested reviewers

  • TkDodo

Poem

🐰 I hopped through changes, neat and spry,
Grouped packages lined up by and by,
A tiny version went away,
Patches noted — hip hooray! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title 'ci(changesets): fixed version' accurately describes the main change—configuring fixed versions in the changeset configuration for TanStack Query packages to align versions.
Description check ✅ Passed The description comprehensively covers the problem (version misalignment), the motivation (simplified upgrades), and expected outcome. It follows the template structure with a detailed problem statement, current/to-be comparison, and completed checklist items.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Comment @coderabbitai help to get the list of available commands and usage tips.

@nx-cloud
Copy link

nx-cloud bot commented Jan 21, 2026

View your CI Pipeline Execution ↗ for commit c728d51

Command Status Duration Result
nx affected --targets=test:sherif,test:knip,tes... ✅ Succeeded 43s View ↗
nx run-many --target=build --exclude=examples/*... ✅ Succeeded 2s View ↗

☁️ Nx Cloud last updated this comment at 2026-01-27 10:26:50 UTC

@manudeli manudeli changed the title chore: update changeset configuration to include fixed dependencies for various TanStack packages ci(changesets): fixed version Jan 21, 2026
@pkg-pr-new
Copy link

pkg-pr-new bot commented Jan 21, 2026

More templates

@tanstack/angular-query-experimental

npm i https://pkg.pr.new/@tanstack/angular-query-experimental@10064

@tanstack/eslint-plugin-query

npm i https://pkg.pr.new/@tanstack/eslint-plugin-query@10064

@tanstack/query-async-storage-persister

npm i https://pkg.pr.new/@tanstack/query-async-storage-persister@10064

@tanstack/query-broadcast-client-experimental

npm i https://pkg.pr.new/@tanstack/query-broadcast-client-experimental@10064

@tanstack/query-core

npm i https://pkg.pr.new/@tanstack/query-core@10064

@tanstack/query-devtools

npm i https://pkg.pr.new/@tanstack/query-devtools@10064

@tanstack/query-persist-client-core

npm i https://pkg.pr.new/@tanstack/query-persist-client-core@10064

@tanstack/query-sync-storage-persister

npm i https://pkg.pr.new/@tanstack/query-sync-storage-persister@10064

@tanstack/react-query

npm i https://pkg.pr.new/@tanstack/react-query@10064

@tanstack/react-query-devtools

npm i https://pkg.pr.new/@tanstack/react-query-devtools@10064

@tanstack/react-query-next-experimental

npm i https://pkg.pr.new/@tanstack/react-query-next-experimental@10064

@tanstack/react-query-persist-client

npm i https://pkg.pr.new/@tanstack/react-query-persist-client@10064

@tanstack/solid-query

npm i https://pkg.pr.new/@tanstack/solid-query@10064

@tanstack/solid-query-devtools

npm i https://pkg.pr.new/@tanstack/solid-query-devtools@10064

@tanstack/solid-query-persist-client

npm i https://pkg.pr.new/@tanstack/solid-query-persist-client@10064

@tanstack/svelte-query

npm i https://pkg.pr.new/@tanstack/svelte-query@10064

@tanstack/svelte-query-devtools

npm i https://pkg.pr.new/@tanstack/svelte-query-devtools@10064

@tanstack/svelte-query-persist-client

npm i https://pkg.pr.new/@tanstack/svelte-query-persist-client@10064

@tanstack/vue-query

npm i https://pkg.pr.new/@tanstack/vue-query@10064

@tanstack/vue-query-devtools

npm i https://pkg.pr.new/@tanstack/vue-query-devtools@10064

commit: 04405d8

@github-actions
Copy link
Contributor

github-actions bot commented Jan 21, 2026

size-limit report 📦

Path Size
react full 11.93 KB (0%)
react minimal 8.95 KB (0%)

Comment on lines 32 to 37
["@tanstack/vue-query-devtools"],
[
"@tanstack/svelte-query",
"@tanstack/svelte-query-devtools",
"@tanstack/svelte-query-persist-client"
]
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Practical constraint

Some packages have already moved to a new major version, including:

  • @tanstack/vue-query-devtools
  • @tanstack/svelte-query
  • @tanstack/svelte-query-devtools
  • @tanstack/svelte-query-persist-client

Re-aligning these packages is no longer realistic, so pinning them to fixed versions is unavoidable.
Even so, this still appears to be the best available option to restore predictability for users.

@sentry
Copy link

sentry bot commented Jan 21, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 42.72%. Comparing base (ed5e5fc) to head (c728d51).

Additional details and impacted files

Impacted file tree graph

@@            Coverage Diff             @@
##             main   #10064      +/-   ##
==========================================
+ Coverage   36.87%   42.72%   +5.85%     
==========================================
  Files         245      175      -70     
  Lines       11103     8267    -2836     
  Branches     2083     1678     -405     
==========================================
- Hits         4094     3532     -562     
+ Misses       6484     4345    -2139     
+ Partials      525      390     -135     
Components Coverage Δ
@tanstack/angular-query-experimental 46.35% <ø> (ø)
@tanstack/eslint-plugin-query ∅ <ø> (∅)
@tanstack/query-async-storage-persister 43.85% <ø> (ø)
@tanstack/query-broadcast-client-experimental 24.39% <ø> (ø)
@tanstack/query-codemods ∅ <ø> (∅)
@tanstack/query-core 75.55% <ø> (ø)
@tanstack/query-devtools 3.38% <ø> (ø)
@tanstack/query-persist-client-core 80.12% <ø> (ø)
@tanstack/query-sync-storage-persister 84.61% <ø> (ø)
@tanstack/query-test-utils 77.77% <ø> (ø)
@tanstack/react-query 29.00% <ø> (ø)
@tanstack/react-query-devtools 9.25% <ø> (ø)
@tanstack/react-query-next-experimental ∅ <ø> (∅)
@tanstack/react-query-persist-client 100.00% <ø> (ø)
@tanstack/solid-query 53.52% <ø> (ø)
@tanstack/solid-query-devtools 64.17% <ø> (ø)
@tanstack/solid-query-persist-client 100.00% <ø> (ø)
@tanstack/svelte-query ∅ <ø> (∅)
@tanstack/svelte-query-devtools ∅ <ø> (∅)
@tanstack/svelte-query-persist-client ∅ <ø> (∅)
@tanstack/vue-query 35.67% <ø> (ø)
@tanstack/vue-query-devtools ∅ <ø> (∅)
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@manudeli manudeli force-pushed the changesets/fixed-version branch from e08c370 to bbebbfe Compare January 21, 2026 10:16
@manudeli manudeli marked this pull request as ready for review January 21, 2026 10:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants