Framework
Version

Installation

You can install React Query via NPM, or a good ol' <script> via unpkg.com.

NPM

bash
npm i @tanstack/react-query@4
npm i @tanstack/react-query@4

or

bash
pnpm add @tanstack/react-query@4
pnpm add @tanstack/react-query@4

or

bash
yarn add @tanstack/react-query@4
yarn add @tanstack/react-query@4

React Query is compatible with React v16.8+ and works with ReactDOM and React Native.

Wanna give it a spin before you download? Try out the simple or basic examples!

CDN

If you're not using a module bundler or package manager we also have a global ("UMD") build hosted on the unpkg.com CDN. Simply add the following <script> tag to the bottom of your HTML file:

html
<script src="https://unpkg.com/@tanstack/react-query@4/build/umd/index.production.js"></script>
<script src="https://unpkg.com/@tanstack/react-query@4/build/umd/index.production.js"></script>

Once you've added this you will have access to the window.ReactQuery object and its exports.

This installation/usage requires the React CDN script bundles to be on the page as well.

Requirements

React Query is optimized for modern browsers. It is compatible with the following browsers config

Chrome >= 73
Firefox >= 78
Edge >= 79
Safari >= 12.1
iOS >= 12.2
Opera >= 53
Chrome >= 73
Firefox >= 78
Edge >= 79
Safari >= 12.1
iOS >= 12.2
Opera >= 53

Depending on your environment, you might need to add polyfills. If you want to support older browsers, you need to transpile the library from node_modules yourselves.

Recommendations

It is recommended to also use our ESLint Plugin Query to help you catch bugs and inconsistencies while you code. You can install it via:

bash
npm i -D @tanstack/eslint-plugin-query@4
npm i -D @tanstack/eslint-plugin-query@4

or

bash
pnpm add -D @tanstack/eslint-plugin-query@4
pnpm add -D @tanstack/eslint-plugin-query@4

or

bash
yarn add -D @tanstack/eslint-plugin-query@4
yarn add -D @tanstack/eslint-plugin-query@4