You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
64 lines
3.1 KiB
64 lines
3.1 KiB
# React Redux |
|
|
|
Official React bindings for [Redux](https://github.com/reduxjs/redux). |
|
Performant and flexible. |
|
|
|
 [](https://www.npmjs.com/package/react-redux) |
|
[](https://www.npmjs.com/package/react-redux) |
|
[](http://www.reactiflux.com) |
|
|
|
## Installation |
|
|
|
### Using Create React App |
|
|
|
The recommended way to start new apps with React Redux is by using the [official Redux+JS template](https://github.com/reduxjs/cra-template-redux) for [Create React App](https://github.com/facebook/create-react-app), which takes advantage of [Redux Toolkit](https://redux-toolkit.js.org/). |
|
|
|
```sh |
|
npx create-react-app my-app --template redux |
|
``` |
|
|
|
### An Existing React App |
|
|
|
React Redux 7.1 requires **React 16.8.3 or later.** |
|
|
|
To use React Redux with your React app, install it as a dependency: |
|
|
|
```bash |
|
# If you use npm: |
|
npm install react-redux |
|
|
|
# Or if you use Yarn: |
|
yarn add react-redux |
|
``` |
|
|
|
You'll also need to [install Redux](https://redux.js.org/introduction/installation) and [set up a Redux store](https://redux.js.org/recipes/configuring-your-store/) in your app. |
|
|
|
This assumes that you’re using [npm](http://npmjs.com/) package manager |
|
with a module bundler like [Webpack](https://webpack.js.org/) or |
|
[Browserify](http://browserify.org/) to consume [CommonJS |
|
modules](https://webpack.js.org/api/module-methods/#commonjs). |
|
|
|
If you don’t yet use [npm](http://npmjs.com/) or a modern module bundler, and would rather prefer a single-file [UMD](https://github.com/umdjs/umd) build that makes `ReactRedux` available as a global object, you can grab a pre-built version from [cdnjs](https://cdnjs.com/libraries/react-redux). We _don’t_ recommend this approach for any serious application, as most of the libraries complementary to Redux are only available on [npm](http://npmjs.com/). |
|
|
|
## React Native |
|
|
|
As of React Native 0.18, React Redux 5.x should work with React Native. If you have any issues with React Redux 5.x on React Native, run `npm ls react` and make sure you don’t have a duplicate React installation in your `node_modules`. We recommend that you use `npm@3.x` which is better at avoiding these kinds of issues. |
|
|
|
## Documentation |
|
|
|
The React Redux docs are now published at **https://react-redux.js.org** . |
|
|
|
We're currently expanding and rewriting our docs content - check back soon for more updates! |
|
|
|
## How Does It Work? |
|
|
|
We do a deep dive on how React Redux works in [this readthesource episode](https://www.youtube.com/watch?v=VJ38wSFbM3A). |
|
|
|
Also, the post [The History and Implementation of React-Redux](https://blog.isquaredsoftware.com/2018/11/react-redux-history-implementation/) |
|
explains what it does, how it works, and how the API and implementation have evolved over time. |
|
|
|
Enjoy! |
|
|
|
## License |
|
|
|
[MIT](LICENSE.md)
|
|
|