{"id":13394501,"url":"https://github.com/amplitude/redux-query","last_synced_at":"2025-05-14T19:06:40.126Z","repository":{"id":17434671,"uuid":"81507373","full_name":"amplitude/redux-query","owner":"amplitude","description":"A library for managing network state in Redux","archived":false,"fork":false,"pushed_at":"2023-12-12T17:37:54.000Z","size":12920,"stargazers_count":1100,"open_issues_count":14,"forks_count":68,"subscribers_count":97,"default_branch":"master","last_synced_at":"2025-02-21T11:50:45.574Z","etag":null,"topics":["amplitude","fetch","hacktoberfest","middleware","react","redux","redux-query","request"],"latest_commit_sha":null,"homepage":"https://amplitude.github.io/redux-query","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/amplitude.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-02-10T00:02:54.000Z","updated_at":"2025-02-18T02:51:33.000Z","dependencies_parsed_at":"2024-05-30T07:13:00.095Z","dependency_job_id":"01eee140-b141-474b-b13b-262e6a578a30","html_url":"https://github.com/amplitude/redux-query","commit_stats":{"total_commits":353,"total_committers":37,"mean_commits":9.54054054054054,"dds":0.5977337110481586,"last_synced_commit":"e0798948a9ff554357abaad97f38acabef4f406e"},"previous_names":[],"tags_count":69,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amplitude%2Fredux-query","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amplitude%2Fredux-query/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amplitude%2Fredux-query/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/amplitude%2Fredux-query/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/amplitude","download_url":"https://codeload.github.com/amplitude/redux-query/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248717242,"owners_count":21150387,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amplitude","fetch","hacktoberfest","middleware","react","redux","redux-query","request"],"created_at":"2024-07-30T17:01:21.800Z","updated_at":"2025-04-13T12:46:48.750Z","avatar_url":"https://github.com/amplitude.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# redux-query\n\n[![Travis](https://img.shields.io/travis/amplitude/redux-query.svg?style=flat-square)](https://travis-ci.org/amplitude/redux-query)\n[![Codecov](https://img.shields.io/codecov/c/github/amplitude/redux-query.svg?style=flat-square)](https://codecov.io/gh/amplitude/redux-query)\n\nA library for managing network state in Redux.\n\n## Why use redux-query?\n\n- **It's simply Redux**: Follow best practices for storing and handling network state in Redux, with support for features like optimistic updates and cancellation. There's no magic here, just middleware, actions, selectors, and reducers.\n- **It's extensible**: Built to fit most use cases out-of-the-box, but can easily be extended with custom Redux middleware, UI integrations, and network interfaces.\n- **It works great with React**: With the provided React hooks and higher-order component in redux-query-react (optional), colocate data dependencies with your components and run requests when components mount or update.\n\n## Docs\n\n- **[Getting Started and Installation](https://amplitude.github.io/redux-query/docs/getting-started)**\n- [Entities](https://amplitude.github.io/redux-query/docs/entities)\n- [Requests vs. Mutations](https://amplitude.github.io/redux-query/docs/requests-vs-mutations)\n- [Query Configs](https://amplitude.github.io/redux-query/docs/query-configs)\n- [Query State](https://amplitude.github.io/redux-query/docs/query-state)\n- [Error State](https://amplitude.github.io/redux-query/docs/error-state)\n- [Network Interfaces](https://amplitude.github.io/redux-query/docs/network-interfaces)\n- [Flow Support](https://amplitude.github.io/redux-query/docs/flow)\n- [Typescript Support](https://amplitude.github.io/redux-query/docs/typescript)\n\n## Redux API\n\n- [Redux Actions](https://amplitude.github.io/redux-query/docs/redux-actions)\n- [Redux Selectors](https://amplitude.github.io/redux-query/docs/redux-selectors)\n\n## React API\n\n- [useRequest](https://amplitude.github.io/redux-query/docs/use-request)\n- [useRequests](https://amplitude.github.io/redux-query/docs/use-requests)\n- [useMutation](https://amplitude.github.io/redux-query/docs/use-mutation)\n- [connectRequest](https://amplitude.github.io/redux-query/docs/connect-request)\n\n## Examples\n\n- [Simple example](https://amplitude.github.io/redux-query/docs/examples/simple): This example is a very simple web app that has only one feature – you can view and update your username. The purpose of this example is to demonstrate how requests and mutations (including optimistic updates) work with redux-query.\n- [Hacker News](https://amplitude.github.io/redux-query/docs/examples/hacker-news): This example shows how to use redux-query, redux-query-react, and redux-query-interface-superagent to build a basic Hacker News client.\n\n## Packages\n\nThis project is published as multiple packages. redux-query, the core library, is the only required package. redux-query-react is recommended if you are using React in your application. redux-query requires a [network interface](https://amplitude.github.io/redux-query/docs/network-interfaces) which handles the implementation of network requests. You must either use the recommended interface, redux-query-interface-superagent, or supply your own.\n\n| Name                                                                              | Version                                                                                                                                                       | Description                                                        |\n| :-------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------- |\n| [`redux-query`](./packages/redux-query)                                           | [![npm](https://img.shields.io/npm/v/redux-query.svg?style=flat-square)](https://www.npmjs.com/package/redux-query)                                           | The core library for managing network requests with Redux.         |\n| [`redux-query-react`](./packages/redux-query-react)                               | [![npm](https://img.shields.io/npm/v/redux-query-react.svg?style=flat-square)](https://www.npmjs.com/package/redux-query-react)                               | Library of APIs for integrating redux-query with React components. |\n| [`redux-query-interface-superagent`](./packages/redux-query-interface-superagent) | [![npm](https://img.shields.io/npm/v/redux-query-interface-superagent.svg?style=flat-square)](https://www.npmjs.com/package/redux-query-interface-superagent) | The recommended network interface that handles network requests.   |\n\n## Upgrade guides\n\n- [1.x to 2.x](https://amplitude.github.io/redux-query/docs/upgrade-guides/v1-to-v2)\n- [2.x to 3.x](https://amplitude.github.io/redux-query/docs/upgrade-guides/v2-to-v3)\n\n## Contributing\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md).\n\n## License\n\n[MIT](https://github.com/amplitude/redux-query/blob/master/LICENSE)\n\n## About\n\nBrought to you by [Amplitude Engineering](https://amplitude.com/engineering). We're hiring!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famplitude%2Fredux-query","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famplitude%2Fredux-query","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famplitude%2Fredux-query/lists"}