2023-12-19 10:32:51 -07:00
<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=be2d8a11-9712-4c1d-9963-580b2d4fb133" />
2020-08-13 16:57:09 -05:00
2025-09-12 02:20:50 -07:00
<div align="center">
<img src="./media/header_query.png" alt="TanStack Query" />
</div>
<br />
<div align="center">
2025-11-01 07:29:15 -07:00
<a href="https://www.npmjs.com/package/@tanstack/query -core" target="_parent">
2025-09-12 02:20:50 -07:00
<img alt="" src="https://img.shields.io/npm/dm/@tanstack/query -core.svg" alt="npm downloads" />
2019-09-10 13:22:26 -06:00
</a>
2025-11-01 20:09:42 +02:00
<a href="https://github.com/TanStack/query/stargazers" target="_parent">
2025-09-12 02:20:50 -07:00
<img alt="" src="https://img.shields.io/github/stars/TanStack/query.svg?style=social&label=Star" alt="GitHub stars" />
</a>
2025-11-01 07:29:15 -07:00
<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">
2025-09-12 02:20:50 -07:00
<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>
</div>
<div align="center">
<a href="#badge ">
2025-09-13 23:48:04 -07:00
<img src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg" alt="semantic-release">
2025-09-12 02:20:50 -07:00
</a>
2025-09-13 23:48:04 -07:00
<a href="https://bestofjs.org/projects/tanstack-query"><img src="https://img.shields.io/endpoint?url=https://bestofjs-serverless.now.sh/api/project-badge?fullName=TanStack%2Fquery%26since=daily" alt="Best of JS" /></a>
2025-09-12 02:20:50 -07:00
<a href="https://twitter.com/tan_stack"><img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack "/></a>
</div>
2025-09-13 23:48:04 -07:00
<div align="center">
2019-11-04 14:40:53 -07:00
2025-09-13 23:48:04 -07:00
### [Become a Sponsor!](https://github.com/sponsors/tannerlinsley/)
2020-07-08 00:00:01 -06:00
2025-09-12 02:20:50 -07:00
</div>
2019-11-14 10:00:42 -07:00
2025-09-13 23:48:04 -07:00
# TanStack Query
An async state management library built to simplify fetching, caching, synchronizing, and updating server state.
- Protocolโ agnostic fetching (REST, GraphQL, promises, etc.)
- Caching, refetching, pagination & infinite scroll
- Mutations, dependent queries & background updates
- Prefetching, cancellation & React Suspense support
### <a href="https://tanstack.com/query">Read the docs โ</b></a>
2022-06-24 08:31:23 -06:00
2025-09-12 02:20:50 -07:00
## Get Involved
2019-11-02 14:37:07 -06:00
2025-09-12 02:20:50 -07:00
- We welcome issues and pull requests!
- Participate in [GitHub discussions ](https://github.com/TanStack/query/discussions )
- Chat with the community on [Discord ](https://discord.com/invite/WrRKjPJ )
- See [CONTRIBUTING.md ](./CONTRIBUTING.md ) for setup instructions
2019-11-02 14:37:07 -06:00
2025-05-08 10:19:18 -06:00
## Partners
2025-09-13 23:48:04 -07:00
<table align="center">
<tr>
<td>
2025-09-19 09:37:54 -07:00
<a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" >
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-CMcuvjEy.svg" height="40" />
<source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-DVMJ2jHi.svg" height="40" />
<img src="https://tanstack.com/assets/coderabbit-light-DVMJ2jHi.svg" height="40" alt="CodeRabbit" />
</picture>
</a>
2025-09-13 23:48:04 -07:00
</td>
2025-09-19 09:37:54 -07:00
<td>
2025-09-13 23:48:04 -07:00
<a href="https://www.cloudflare.com?utm_source=tanstack">
2025-09-19 09:37:54 -07:00
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-DQDB7UaL.svg" height="60" />
<source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-CPufaW0B.svg" height="60" />
<img src="https://tanstack.com/assets/cloudflare-black-CPufaW0B.svg" height="60" alt="Cloudflare" />
</picture>
2025-09-13 23:48:04 -07:00
</a>
</td>
</tr>
</table>
<div align="center">
<img src="./media/partner_logo.svg" alt="Query & you?" height="65">
<p>
We're looking for TanStack Query Partners to join our mission! Partner with us to push the boundaries of TanStack Query and build amazing things together.
</p>
<a href="mailto:partners@tanstack .com?subject=TanStack Query Partnership"><b>LET'S CHAT</b></a>
</div>
2025-09-12 02:20:50 -07:00
</div>
2025-05-08 10:19:18 -06:00
2025-09-12 02:20:50 -07:00
## Explore the TanStack Ecosystem
2024-08-06 13:42:28 +05:30
2025-09-13 23:48:04 -07:00
- <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> โ Tooling for JS/TS packages
- <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> โ Reactive sync client store
- <a href="https://github.com/tanstack/devtools"><b>TanStack DevTools</b></a> โ Unified devtools panel
- <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> โ Typeโ safe form state
- <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> โ Debouncing, throttling, batching <br/>
- <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> โ Async state & caching
- <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> โ Range & slider primitives
- <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> โ Typeโ safe routing, caching & URL state
- <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> โ Fullโ stack SSR & streaming
- <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> โ Reactive data store
- <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> โ Headless datagrids
- <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> โ Virtualized rendering
โฆ and more at <a href="https://tanstack.com"><b>TanStack.com ยป</b></a>
2020-04-18 20:15:41 +05:30
2025-06-21 14:04:03 +02:00
<!-- Use the force, Luke -->