Skip to content

Conversation

@LadyBluenotes
Copy link
Contributor

@LadyBluenotes LadyBluenotes commented Sep 10, 2025

Summary:

  • Updated the README to improve feature overview and descriptions.
  • Refined wording for clarity and consistency across product blurbs and feature lists.
  • Updated header images so it's consistent with other libraries

Note: The image is currently a relative link and I see the previous ones aren't so that might need to be updated.

Summary by CodeRabbit

  • Documentation
    • Refreshed README with a centered header image, concise library description, and short bulleted feature list.
    • Reworked hero to highlight capabilities and added a prominent "Read the Query Docs →" link.
    • Reorganized and centered badges (npm, GitHub stars, bundle size, releases, Best of JS, Twitter).
    • Replaced quick-features with "Get Involved" community guidance; expanded ecosystem links and redesigned Partners section.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Sep 10, 2025

Walkthrough

README.md was overhauled: header and badges replaced with a centered local image, hero rewritten with a concise description and feature bullets, docs CTA added, legacy/versioned sections removed, Get Involved and Explore the TanStack Ecosystem sections added, and partners/contributing/layout updated.

Changes

Cohort / File(s) Summary
README overhaul
README.md
Replaced external header with centered local header_query.png; rewrote hero to a concise library description and core capability bullets; added "Read the Query Docs" CTA; reorganized badges into centered groups; removed legacy/versioned docs and Quick Features; added Get Involved and Explore the TanStack Ecosystem sections; updated partners/sponsor layout and assorted HTML/layout tweaks.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Pre-merge checks (3 passed)

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title Check ✅ Passed The title "docs: README Updates" directly reflects the PR's primary change set (extensive README rework, header image and content updates) as shown in the raw summary and PR objectives, and it is concise and uses the conventional "docs:" prefix so reviewers can immediately see the scope.
Docstring Coverage ✅ Passed No functions found in the changes. Docstring coverage check skipped.

Poem

I hopped through lines and cleaned the spread,
Swapped heavy headers for a simple thread.
Badges aligned, docs shining bright,
Ecosystem paths glowing in the night.
Come nibble docs — let's code and delight. 🥕

Tip

👮 Agentic pre-merge checks are now available in preview!

Pro plan users can now enable pre-merge checks in their settings to enforce checklists before merging PRs.

  • Built-in checks – Quickly apply ready-made checks to enforce title conventions, require pull request descriptions that follow templates, validate linked issues for compliance, and more.
  • Custom agentic checks – Define your own rules using CodeRabbit’s advanced agentic capabilities to enforce organization-specific policies and workflows. For example, you can instruct CodeRabbit’s agent to verify that API documentation is updated whenever API schema files are modified in a PR. Note: Upto 5 custom checks are currently allowed during the preview period. Pricing for this feature will be announced in a few weeks.

Please see the documentation for more information.

Example:

reviews:
  pre_merge_checks:
    custom_checks:
      - name: "Undocumented Breaking Changes"
        mode: "warning"
        instructions: |
          Pass/fail criteria: All breaking changes to public APIs, CLI flags, environment variables, configuration keys, database schemas, or HTTP/GraphQL endpoints must be documented in the "Breaking Change" section of the PR description and in CHANGELOG.md. Exclude purely internal or private changes (e.g., code not exported from package entry points or explicitly marked as internal).

Please share your feedback with us on this Discord post.

✨ Finishing touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 4

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
README.md (1)

3-74: Fix duplicate attributes, update link targets, and verify external URLs

  • Remove duplicate alt attributes on badge images in README.md (e.g. the shields at lines ~21, 24, 27).
  • Remove or correct target="_parent" on links (lines ~20, 23, 26); GitHub strips those attributes.
  • Replace ./media/header_query.png with an absolute URL for npm-hosted README.
  • Manually verify all external badges and links: npm download badge, Best of JS endpoint, bundle-size badge, and the Discord invite (WrRKjPJ).
🧹 Nitpick comments (4)
README.md (4)

14-16: Inline style won’t render on GitHub

GitHub strips most inline style attributes. Use semantic markup instead.

-<a href="https://tanstack.com/query" style="font-weight: bold">Read the Query Docs →</a>
+<a href="https://tanstack.com/query"><strong>Read the Query Docs →</strong></a>

17-17: Superfluous inline styles

The flex styles will be ignored by GitHub; simpler markup is safer.

-<div align="center" style="display: flex; gap: 10px; flex-direction: column; justify-content: center;">
+<div align="center">

56-74: Optional: inline styles in Partners section

The flex styles may be stripped on GitHub; content will degrade to a vertical list. Acceptable, but consider removing styles or using simple center alignment for predictable rendering.

Do you want this layout to render identically on npm and GitHub? If yes, I can propose a style-free variant.


36-36: Minor: Badge alt text handle mismatch

Alt says “Follow @TanStack” but the handle is @tan_stack.

-  <a href="https://twitter.com/tan_stack"><img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/></a>
+  <a href="https://twitter.com/tan_stack"><img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @tan_stack"/></a>
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 230435d and 6d083c4.

⛔ Files ignored due to path filters (1)
  • media/header_query.png is excluded by !**/*.png
📒 Files selected for processing (1)
  • README.md (2 hunks)
🧰 Additional context used
🪛 markdownlint-cli2 (0.17.2)
README.md

4-4: Images should have alternate text (alt text)

(MD045, no-alt-text)

🔇 Additional comments (1)
README.md (1)

3-5: Add alt text to header image in README.md
Add an alt attribute to satisfy MD045. For example:

-  <img src="./media/header_query.png">
+  <img alt="TanStack Query" src="./media/header_query.png">

Comment on lines 78 to 91
<div align="center">
<a href="https://github.com/tanstack/config" style="font-weight: bold;">TanStack Config</a> – Tooling for JS/TS packages <br/>
<a href="https://github.com/tanstack/db" style="font-weight: bold;">TanStack DB</a> – Reactive sync client store <br/>
<a href="https://github.com/tanstack/config" style="font-weight: bold;">TanStack DevTools</a> – Unified devtools panel <br/>
<a href="https://github.com/tanstack/form" style="font-weight: bold;">TanStack Form</a> – Type‑safe form state <br/>
<a href="https://github.com/tanstack/pacer" style="font-weight: bold;">TanStack Pacer</a> – Debouncing, throttling, batching <br/>
<a href="https://github.com/tanstack/ranger" style="font-weight: bold;">TanStack Ranger</a> – Range & slider primitives <br/>
<a href="https://github.com/tanstack/router" style="font-weight: bold;">TanStack Router</a> – Type‑safe routing, caching & URL state<br/>
<a href="https://github.com/tanstack/router" style="font-weight: bold;">TanStack Start</a> – Full‑stack SSR & streaming<br/>
<a href="https://github.com/tanstack/store" style="font-weight: bold;">TanStack Store</a> – Reactive data store <br/>
<a href="https://github.com/tanstack/table" style="font-weight: bold;">TanStack Table</a> – Headless datagrids <br/>
<a href="https://github.com/tanstack/virtual" style="font-weight: bold;">TanStack Virtual</a> – Virtualized rendering <br/>
… and more at <a href="https://tanstack.com" style="font-weight: bold;">TanStack.com »</a>
</div>
Copy link
Contributor

Choose a reason for hiding this comment

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

💡 Verification agent

❓ Verification inconclusive

Fix likely copy/paste link errors in Ecosystem

DevTools and Start link to the wrong repos.

-  <a href="https://github.com/tanstack/config" style="font-weight: bold;">TanStack DevTools</a> – Unified devtools panel <br/>
+  <a href="https://github.com/tanstack/devtools" style="font-weight: bold;">TanStack DevTools</a> – Unified devtools panel <br/>
@@
-  <a href="https://github.com/tanstack/router" style="font-weight: bold;">TanStack Start</a> –  Full‑stack SSR & streaming<br/>
+  <a href="https://github.com/tanstack/start" style="font-weight: bold;">TanStack Start</a> –  Full‑stack SSR & streaming<br/>

Also consider removing inline styles across this block for consistency with GitHub’s sanitizer.


Fix copy/paste link errors and remove inline styles

🤖 Prompt for AI Agents
In README.md around lines 78 to 91, there are copy/paste link errors and inline
style attributes; update the TanStack DevTools link href to
https://github.com/tanstack/devtools and the TanStack Start link href to
https://github.com/tanstack/start, and remove all style="font-weight: bold;"
attributes in this block so links rely on normal markdown/HTML styling and are
compatible with GitHub’s sanitizer.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

♻️ Duplicate comments (4)
README.md (4)

17-29: Clean badges block: drop target attributes and duplicate alt; avoid inline styles

  • target="..." is stripped by GitHub.
  • Each has duplicate alt; keep a single meaningful alt.
  • The outer div’s style won’t render; remove it.
-<div align="center" style="display: flex; gap: 10px; flex-direction: column; justify-content: center;">
+<div align="center">
@@
-<a href="https://www.npmjs.com/package/@tanstack/query-core" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/query-core.svg" alt="npm downloads" />
+<a href="https://www.npmjs.com/package/@tanstack/query-core">
+  <img alt="npm downloads" src="https://img.shields.io/npm/dm/@tanstack/query-core.svg" />
 </a>
- <a href="https://github.com/TanStack/query/" target="\_parent">
-  <img alt="" src="https://img.shields.io/github/stars/TanStack/query.svg?style=social&label=Star" alt="GitHub stars" />
+ <a href="https://github.com/TanStack/query/">
+  <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/query.svg?style=social&label=Star" />
 </a>
-<a href="https://bundlejs.com/?q=%40tanstack%2Freact-query&config=%7B%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react-dom%22%5D%7D%7D&badge=" target="\_parent">
-  <img alt="" src="https://deno.bundlejs.com/?q=@tanstack/react-query&config={%22esbuild%22:{%22external%22:[%22react%22,%22react-dom%22]}}&badge=detailed" alt="Bundle size" />
+<a href="https://bundlejs.com/?q=%40tanstack%2Freact-query&config=%7B%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react-dom%22%5D%7D%7D&badge=">
+  <img alt="Bundle size" src="https://deno.bundlejs.com/?q=@tanstack/react-query&config={%22esbuild%22:{%22external%22:[%22react%22,%22react-dom%22]}}&badge=detailed" />
 </a>

31-37: Fix broken anchor on semantic-release badge

href="#badge" points nowhere; link to the project instead.

-<a href="#badge">
+<a href="https://github.com/semantic-release/semantic-release" rel="nofollow">
     <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
   </a>

39-43: Markdown inside HTML div won’t render; convert to HTML and drop styles

GitHub does not parse Markdown within HTML blocks; inline styles are stripped.

-<div align="center" style="font-size: 2rem; font-weight: bolder;">
-
-[Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-
-</div>
+<div align="center">
+  <a href="https://github.com/sponsors/tannerlinsley/"><strong>Become a Sponsor!</strong></a>
+</div>

78-91: Fix Start link target and remove inline styles across Ecosystem block

  • TanStack Start incorrectly links to /router; should be /start.
  • Remove inline styles; rely on default styling or .
-<div align="center">
-<a href="https://github.com/tanstack/config" style="font-weight: bold;">TanStack Config</a> – Tooling for JS/TS packages <br/>
-  <a href="https://github.com/tanstack/db" style="font-weight: bold;">TanStack DB</a> – Reactive sync client store <br/>
-  <a href="https://github.com/tanstack/devtools" style="font-weight: bold;">TanStack DevTools</a> – Unified devtools panel <br/>
-  <a href="https://github.com/tanstack/form" style="font-weight: bold;">TanStack Form</a> – Type‑safe form state <br/>
-  <a href="https://github.com/tanstack/pacer" style="font-weight: bold;">TanStack Pacer</a> – Debouncing, throttling, batching <br/>
-  <a href="https://github.com/tanstack/ranger" style="font-weight: bold;">TanStack Ranger</a> – Range & slider primitives <br/>
-  <a href="https://github.com/tanstack/router" style="font-weight: bold;">TanStack Router</a> –  Type‑safe routing, caching & URL state<br/>
-  <a href="https://github.com/tanstack/router" style="font-weight: bold;">TanStack Start</a> –  Full‑stack SSR & streaming<br/>
-  <a href="https://github.com/tanstack/store" style="font-weight: bold;">TanStack Store</a> – Reactive data store <br/>
-  <a href="https://github.com/tanstack/table" style="font-weight: bold;">TanStack Table</a> – Headless datagrids <br/>
-  <a href="https://github.com/tanstack/virtual" style="font-weight: bold;">TanStack Virtual</a> – Virtualized rendering <br/>
-  … and more at <a href="https://tanstack.com" style="font-weight: bold;">TanStack.com »</a>
+<div align="center">
+<a href="https://github.com/tanstack/config"><strong>TanStack Config</strong></a> – Tooling for JS/TS packages <br/>
+  <a href="https://github.com/tanstack/db"><strong>TanStack DB</strong></a> – Reactive sync client store <br/>
+  <a href="https://github.com/tanstack/devtools"><strong>TanStack DevTools</strong></a> – Unified devtools panel <br/>
+  <a href="https://github.com/tanstack/form"><strong>TanStack Form</strong></a> – Type‑safe form state <br/>
+  <a href="https://github.com/tanstack/pacer"><strong>TanStack Pacer</strong></a> – Debouncing, throttling, batching <br/>
+  <a href="https://github.com/tanstack/ranger"><strong>TanStack Ranger</strong></a> – Range & slider primitives <br/>
+  <a href="https://github.com/tanstack/router"><strong>TanStack Router</strong></a> –  Type‑safe routing, caching & URL state<br/>
+  <a href="https://github.com/tanstack/start"><strong>TanStack Start</strong></a> –  Full‑stack SSR & streaming<br/>
+  <a href="https://github.com/tanstack/store"><strong>TanStack Store</strong></a> – Reactive data store <br/>
+  <a href="https://github.com/tanstack/table"><strong>TanStack Table</strong></a> – Headless datagrids <br/>
+  <a href="https://github.com/tanstack/virtual"><strong>TanStack Virtual</strong></a> – Virtualized rendering <br/>
+  … and more at <a href="https://tanstack.com"><strong>TanStack.com »</strong></a>
 </div>
🧹 Nitpick comments (2)
README.md (2)

14-16: Remove inline style; use semantic bold for Docs link

GitHub strips most inline styles. Prefer strong.

-<a href="https://tanstack.com/query" style="font-weight: bold">Read the Query Docs →</a>
+<a href="https://tanstack.com/query"><strong>Read the Query Docs →</strong></a>

56-74: Inline styles likely stripped; simplify Partners wrapper

GitHub sanitizes style attributes; layout is fine without them.

-<div style="display: flex; flex-wrap: wrap; gap: 50px; justify-content: center; align-items: center;">
+<div>
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 6d083c4 and 14a542c.

📒 Files selected for processing (1)
  • README.md (2 hunks)
🧰 Additional context used
🪛 markdownlint-cli2 (0.17.2)
README.md

4-4: Images should have alternate text (alt text)

(MD045, no-alt-text)

🔇 Additional comments (1)
README.md (1)

7-13: LGTM: succinct feature bullets

Clear, scannable, and accurate.

@TkDodo TkDodo changed the title README Updates docs: README Updates Sep 11, 2025
@nx-cloud
Copy link

nx-cloud bot commented Sep 11, 2025

View your CI Pipeline Execution ↗ for commit 14a542c

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

☁️ Nx Cloud last updated this comment at 2025-09-11 11:12:16 UTC

@pkg-pr-new
Copy link

pkg-pr-new bot commented Sep 11, 2025

More templates

@tanstack/angular-query-devtools-experimental

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

@tanstack/angular-query-experimental

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

@tanstack/eslint-plugin-query

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

@tanstack/query-async-storage-persister

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

@tanstack/query-broadcast-client-experimental

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

@tanstack/query-core

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

@tanstack/query-devtools

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

@tanstack/query-persist-client-core

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

@tanstack/query-sync-storage-persister

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

@tanstack/react-query

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

@tanstack/react-query-devtools

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

@tanstack/react-query-next-experimental

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

@tanstack/react-query-persist-client

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

@tanstack/solid-query

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

@tanstack/solid-query-devtools

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

@tanstack/solid-query-persist-client

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

@tanstack/svelte-query

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

@tanstack/svelte-query-devtools

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

@tanstack/svelte-query-persist-client

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

@tanstack/vue-query

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

@tanstack/vue-query-devtools

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

commit: 14a542c

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

♻️ Duplicate comments (5)
README.md (5)

7-7: Avoid calling Query a “data‑fetching library”; use async state management wording.

This aligns with how the project is positioned (async state + server‑state utilities; not tied to fetching only).

-A data‑fetching library built to simplify fetching, caching, synchronizing, and updating server state.
+Powerful asynchronous state management, server‑state utilities, and data fetching. Fetch, cache, update, and wrangle async data in your JS/TS, React, Vue, Solid, Svelte & Angular apps without touching "global state".

19-28: Duplicate alt attributes and unsupported target attributes on badges.

Keep one meaningful alt; remove target="…".

-<a href="https://www.npmjs.com/package/@tanstack/query-core" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/query-core.svg" alt="npm downloads" />
+<a href="https://www.npmjs.com/package/@tanstack/query-core">
+  <img alt="npm downloads" src="https://img.shields.io/npm/dm/@tanstack/query-core.svg" />
 </a>
- <a href="https://github.com/TanStack/query/" target="\_parent">
-  <img alt="" src="https://img.shields.io/github/stars/TanStack/query.svg?style=social&label=Star" alt="GitHub stars" />
+ <a href="https://github.com/TanStack/query/">
+  <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/query.svg?style=social&label=Star" />
 </a>
-<a href="https://bundlejs.com/?q=%40tanstack%2Freact-query&config=%7B%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react-dom%22%5D%7D%7D&badge=" target="\_parent">
-  <img alt="" src="https://deno.bundlejs.com/?q=@tanstack/react-query&config={%22esbuild%22:{%22external%22:[%22react%22,%22react-dom%22]}}&badge=detailed" alt="Bundle size" />
+<a href="https://bundlejs.com/?q=%40tanstack%2Freact-query&config=%7B%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react-dom%22%5D%7D%7D&badge=">
+  <img alt="Bundle size" src="https://deno.bundlejs.com/?q=@tanstack/react-query&config={%22esbuild%22:{%22external%22:[%22react%22,%22react-dom%22]}}&badge=detailed" />
 </a>

32-34: Broken semantic‑release badge link (href="#badge").

Link to the project/docs instead.

-<a href="#badge">
+<a href="https://github.com/semantic-release/semantic-release" rel="nofollow">
     <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
   </a>

39-43: Markdown inside HTML block won’t render on GitHub.

Use an HTML anchor or move the link outside the div.

-<div align="center" style="font-size: 2rem; font-weight: bolder;">
-
-[Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-
-</div>
+<div align="center"><a href="https://github.com/sponsors/tannerlinsley/"><strong>Become a Sponsor!</strong></a></div>

78-91: Fix Start link and remove inline styles across Ecosystem block.

DevTools is correct; Start should point to tanstack/start. Also drop style="font-weight: bold;".

-<div align="center">
-<a href="https://github.com/tanstack/config" style="font-weight: bold;">TanStack Config</a> – Tooling for JS/TS packages <br/>
-  <a href="https://github.com/tanstack/db" style="font-weight: bold;">TanStack DB</a> – Reactive sync client store <br/>
-  <a href="https://github.com/tanstack/devtools" style="font-weight: bold;">TanStack DevTools</a> – Unified devtools panel <br/>
-  <a href="https://github.com/tanstack/form" style="font-weight: bold;">TanStack Form</a> – Type‑safe form state <br/>
-  <a href="https://github.com/tanstack/pacer" style="font-weight: bold;">TanStack Pacer</a> – Debouncing, throttling, batching <br/>
-  <a href="https://github.com/tanstack/ranger" style="font-weight: bold;">TanStack Ranger</a> – Range & slider primitives <br/>
-  <a href="https://github.com/tanstack/router" style="font-weight: bold;">TanStack Router</a> –  Type‑safe routing, caching & URL state<br/>
-  <a href="https://github.com/tanstack/router" style="font-weight: bold;">TanStack Start</a> –  Full‑stack SSR & streaming<br/>
-  <a href="https://github.com/tanstack/store" style="font-weight: bold;">TanStack Store</a> – Reactive data store <br/>
-  <a href="https://github.com/tanstack/table" style="font-weight: bold;">TanStack Table</a> – Headless datagrids <br/>
-  <a href="https://github.com/tanstack/virtual" style="font-weight: bold;">TanStack Virtual</a> – Virtualized rendering <br/>
-  … and more at <a href="https://tanstack.com" style="font-weight: bold;">TanStack.com »</a>
+<div align="center">
+<a href="https://github.com/tanstack/config"><strong>TanStack Config</strong></a> – Tooling for JS/TS packages <br/>
+  <a href="https://github.com/tanstack/db"><strong>TanStack DB</strong></a> – Reactive sync client store <br/>
+  <a href="https://github.com/tanstack/devtools"><strong>TanStack DevTools</strong></a> – Unified devtools panel <br/>
+  <a href="https://github.com/tanstack/form"><strong>TanStack Form</strong></a> – Type‑safe form state <br/>
+  <a href="https://github.com/tanstack/pacer"><strong>TanStack Pacer</strong></a> – Debouncing, throttling, batching <br/>
+  <a href="https://github.com/tanstack/ranger"><strong>TanStack Ranger</strong></a> – Range & slider primitives <br/>
+  <a href="https://github.com/tanstack/router"><strong>TanStack Router</strong></a> – Type‑safe routing, caching & URL state<br/>
+  <a href="https://github.com/tanstack/start"><strong>TanStack Start</strong></a> – Full‑stack SSR & streaming<br/>
+  <a href="https://github.com/tanstack/store"><strong>TanStack Store</strong></a> – Reactive data store <br/>
+  <a href="https://github.com/tanstack/table"><strong>TanStack Table</strong></a> – Headless datagrids <br/>
+  <a href="https://github.com/tanstack/virtual"><strong>TanStack Virtual</strong></a> – Virtualized rendering <br/>
+  … and more at <a href="https://tanstack.com"><strong>TanStack.com »</strong></a>
 </div>
🧹 Nitpick comments (3)
README.md (3)

14-16: Remove inline styles; GitHub strips style attributes in READMEs.

Use semantic HTML/Markdown for emphasis and spacing.

-<a href="https://tanstack.com/query" style="font-weight: bold">Read the Query Docs →</a>
-<br />
+<p><a href="https://tanstack.com/query"><strong>Read the Query Docs →</strong></a></p>

17-17: Drop flex inline styles; they won’t render on GitHub.

-<div align="center" style="display: flex; gap: 10px; flex-direction: column; justify-content: center;">
+<div align="center">

56-56: Inline styles in Partners section are stripped by GitHub.

Use simple centered block without style attributes.

-<div style="display: flex; flex-wrap: wrap; gap: 50px; justify-content: center; align-items: center;">
+<div align="center">
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 14a542c and d1e9a29.

📒 Files selected for processing (1)
  • README.md (2 hunks)
🔇 Additional comments (1)
README.md (1)

3-5: media/header_query.png present — no action required.
Confirmed file exists at repo root; README header image will render.

Co-authored-by: Sarah <[email protected]>
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

♻️ Duplicate comments (4)
README.md (4)

20-28: Remove target attributes and duplicate alt attributes in badges

Targets are stripped by GitHub; each img should have a single, meaningful alt.

-<a href="https://www.npmjs.com/package/@tanstack/query-core" target="\_parent">
-  <img alt="" src="https://img.shields.io/npm/dm/@tanstack/query-core.svg" alt="npm downloads" />
+<a href="https://www.npmjs.com/package/@tanstack/query-core">
+  <img alt="npm downloads" src="https://img.shields.io/npm/dm/@tanstack/query-core.svg" />
 </a>
- <a href="https://github.com/TanStack/query/" target="\_parent">
-  <img alt="" src="https://img.shields.io/github/stars/TanStack/query.svg?style=social&label=Star" alt="GitHub stars" />
+ <a href="https://github.com/TanStack/query/">
+  <img alt="GitHub stars" src="https://img.shields.io/github/stars/TanStack/query.svg?style=social&label=Star" />
 </a>
-<a href="https://bundlejs.com/?q=%40tanstack%2Freact-query&config=%7B%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react-dom%22%5D%7D%7D&badge=" target="\_parent">
-  <img alt="" src="https://deno.bundlejs.com/?q=@tanstack/react-query&config={%22esbuild%22:{%22external%22:[%22react%22,%22react-dom%22]}}&badge=detailed" alt="Bundle size" />
+<a href="https://bundlejs.com/?q=%40tanstack%2Freact-query&config=%7B%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react-dom%22%5D%7D%7D&badge=">
+  <img alt="Bundle size" src="https://deno.bundlejs.com/?q=@tanstack/react-query&config={%22esbuild%22:{%22external%22:[%22react%22,%22react-dom%22]}}&badge=detailed" />
 </a>

31-37: Fix broken semantic-release badge link

href="#badge" points nowhere; link to the project/docs.

-<a href="#badge">
+<a href="https://github.com/semantic-release/semantic-release" rel="nofollow">
     <img alt="semantic-release" src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg">
   </a>

39-43: Markdown inside styled div won’t render as expected

Replace with plain HTML anchor; styles are stripped anyway.

-<div align="center" style="font-size: 2rem; font-weight: bolder;">
-
-[Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
-
-</div>
+<div align="center">
+  <a href="https://github.com/sponsors/tannerlinsley/"><strong>Become a Sponsor!</strong></a>
+</div>

76-91: Fix Start repo link and remove inline bold styles across Ecosystem

Link “TanStack Start” to the correct repo and drop style="font-weight: bold;" which is stripped.

-<div align="center">
-<a href="https://github.com/tanstack/config" style="font-weight: bold;">TanStack Config</a> – Tooling for JS/TS packages <br/>
-  <a href="https://github.com/tanstack/db" style="font-weight: bold;">TanStack DB</a> – Reactive sync client store <br/>
-  <a href="https://github.com/tanstack/devtools" style="font-weight: bold;">TanStack DevTools</a> – Unified devtools panel <br/>
-  <a href="https://github.com/tanstack/form" style="font-weight: bold;">TanStack Form</a> – Type‑safe form state <br/>
-  <a href="https://github.com/tanstack/pacer" style="font-weight: bold;">TanStack Pacer</a> – Debouncing, throttling, batching <br/>
-  <a href="https://github.com/tanstack/ranger" style="font-weight: bold;">TanStack Ranger</a> – Range & slider primitives <br/>
-  <a href="https://github.com/tanstack/router" style="font-weight: bold;">TanStack Router</a> –  Type‑safe routing, caching & URL state<br/>
-  <a href="https://github.com/tanstack/router" style="font-weight: bold;">TanStack Start</a> –  Full‑stack SSR & streaming<br/>
-  <a href="https://github.com/tanstack/store" style="font-weight: bold;">TanStack Store</a> – Reactive data store <br/>
-  <a href="https://github.com/tanstack/table" style="font-weight: bold;">TanStack Table</a> – Headless datagrids <br/>
-  <a href="https://github.com/tanstack/virtual" style="font-weight: bold;">TanStack Virtual</a> – Virtualized rendering <br/>
-  … and more at <a href="https://tanstack.com" style="font-weight: bold;">TanStack.com »</a>
+<div align="center">
+<a href="https://github.com/tanstack/config">TanStack Config</a> – Tooling for JS/TS packages <br/>
+  <a href="https://github.com/tanstack/db">TanStack DB</a> – Reactive sync client store <br/>
+  <a href="https://github.com/tanstack/devtools">TanStack DevTools</a> – Unified devtools panel <br/>
+  <a href="https://github.com/tanstack/form">TanStack Form</a> – Type‑safe form state <br/>
+  <a href="https://github.com/tanstack/pacer">TanStack Pacer</a> – Debouncing, throttling, batching <br/>
+  <a href="https://github.com/tanstack/ranger">TanStack Ranger</a> – Range & slider primitives <br/>
+  <a href="https://github.com/tanstack/router">TanStack Router</a> –  Type‑safe routing, caching & URL state<br/>
+  <a href="https://github.com/tanstack/start">TanStack Start</a> –  Full‑stack SSR & streaming<br/>
+  <a href="https://github.com/tanstack/store">TanStack Store</a> – Reactive data store <br/>
+  <a href="https://github.com/tanstack/table">TanStack Table</a> – Headless datagrids <br/>
+  <a href="https://github.com/tanstack/virtual">TanStack Virtual</a> – Virtualized rendering <br/>
+  … and more at <a href="https://tanstack.com">TanStack.com »</a>

Quick check:

#!/usr/bin/env bash
rg -n 'https://github.com/tanstack/router"|https://github.com/tanstack/start' -n -C0 README.md
🧹 Nitpick comments (3)
README.md (3)

14-16: Use Markdown link; drop unsupported style/br

GitHub strips inline styles; the
isn’t needed here. Use plain Markdown.

-<a href="https://tanstack.com/query" style="font-weight: bold">Read the Query Docs →</a>
-<br />
+[Read the Query Docs →](https://tanstack.com/query)

17-17: Inline flex styles are stripped by GitHub

The layout won’t apply. Remove style= and keep simple blocks.

-<div align="center" style="display: flex; gap: 10px; flex-direction: column; justify-content: center;">
+<div align="center">

56-74: Strip inline styles from Partners wrapper

GitHub sanitizes style=. Keep the container simple; alignment can use align="center" if needed.

-<div style="display: flex; flex-wrap: wrap; gap: 50px; justify-content: center; align-items: center;">
+<div align="center">
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d1e9a29 and c113668.

📒 Files selected for processing (1)
  • README.md (2 hunks)
🔇 Additional comments (3)
README.md (3)

7-13: LGTM: concise positioning + capabilities

The description and bullets align with our messaging and prior guidance.


49-52: LGTM: community calls-to-action

Clear and helpful links for issues, discussions, Discord, and contributing.


3-5: Relative README hero image: file present — prefer absolute URL or ensure media is published

  • media/header_query.png is present in the repo (OK). If the package published to npm excludes media the README hero can 404 — either use an absolute URL (e.g. https://raw.githubusercontent.com/TanStack/query/main/media/header_query.png) or ensure the image is included in the published package (package.json "files" / .npmignore).
  • README gotchas found: inline style= attributes (lines 14, 17, 39, 56, 79–90), target= attributes (lines 20, 23, 26), and duplicate alt attributes on tags (lines 21, 24, 27). Remove duplicate alts and avoid/adjust inline styles/target where possible.

@TkDodo TkDodo merged commit d179168 into TanStack:main Sep 12, 2025
2 checks passed
@coderabbitai coderabbitai bot mentioned this pull request Sep 14, 2025
@LadyBluenotes LadyBluenotes deleted the readme branch September 19, 2025 16:11
Hellol77 pushed a commit to Hellol77/query that referenced this pull request Oct 14, 2025
* readme updates

* fix devtools link

* Apply suggestion from @coderabbitai[bot]

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>

* Update README.md

Co-authored-by: Sarah <[email protected]>

---------

Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
Co-authored-by: Dominik Dorfmeister <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants