Examples

Redux is distributed with a few examples in its source codearrow-up-right. Most of these examples are also on CodeSandboxarrow-up-right, an online editor that lets you play with the examples online.

Counter Vanilla

Run the Counter Vanillaarrow-up-right example:

git clone https://github.com/reactjs/redux.git

cd redux/examples/counter-vanilla
open index.html

It does not require a build system or a view framework and exists to show the raw Redux API used with ES5.

Counter

Run the Counterarrow-up-right example:

git clone https://github.com/reactjs/redux.git

cd redux/examples/counter
npm install
npm start

Or check out the sandboxarrow-up-right:

This is the most basic example of using Redux together with React. For simplicity, it re-renders the React component manually when the store changes. In real projects, you will likely want to use the highly performant React Reduxarrow-up-right bindings instead.

This example includes tests.

Todos

Run the Todosarrow-up-right example:

Or check out the sandboxarrow-up-right.

This is the best example to get a deeper understanding of how the state updates work together with components in Redux. It shows how reducers can delegate handling actions to other reducers, and how you can use React Reduxarrow-up-right to generate container components from your presentational components.

This example includes tests.

Todos with Undo

Run the Todos with Undoarrow-up-right example:

Or check out the sandboxarrow-up-right.

This is a variation on the previous example. It is almost identical, but additionally shows how wrapping your reducer with Redux Undoarrow-up-right lets you add a Undo/Redo functionality to your app with a few lines of code.

Todos w/ Flow

Run the Todos w/ Flowarrow-up-right example:

This is like the previous Todos examples, but shows how to use Redux in conjunction with Flowarrow-up-right.

TodoMVC

Run the TodoMVCarrow-up-right example:

Or check out the sandboxarrow-up-right.

This is the classical TodoMVCarrow-up-right example. It's here for the sake of comparison, but it covers the same points as the Todos example.

This example includes tests.

Shopping Cart

Run the Shopping Cartarrow-up-right example:

Or check out the sandboxarrow-up-right.

This example shows important idiomatic Redux patterns that become important as your app grows. In particular, it shows how to store entities in a normalized way by their IDs, how to compose reducers on several levels, and how to define selectors alongside the reducers so the knowledge about the state shape is encapsulated. It also demonstrates logging with Redux Loggerarrow-up-right and conditional dispatching of actions with Redux Thunkarrow-up-right middleware.

Tree View

Run the Tree Viewarrow-up-right example:

Or check out the sandboxarrow-up-right.

This example demonstrates rendering a deeply nested tree view and representing its state in a normalized form so it is easy to update from reducers. Good rendering performance is achieved by the container components granularly subscribing only to the tree nodes that they render.

This example includes tests.

Async

Run the Asyncarrow-up-right example:

Or check out the sandboxarrow-up-right.

This example includes reading from an asynchronous API, fetching data in response to user input, showing loading indicators, caching the response, and invalidating the cache. It uses Redux Thunkarrow-up-right middleware to encapsulate asynchronous side effects.

Universal

Run the Universalarrow-up-right example:

This is a basic demonstration of server rendering with Redux and React. It shows how to prepare the initial store state on the server, and pass it down to the client so the client store can boot up from an existing state.

Real World

Run the Real Worldarrow-up-right example:

Or check out the sandboxarrow-up-right.

This is the most advanced example. It is dense by design. It covers keeping fetched entities in a normalized cache, implementing a custom middleware for API calls, rendering partially loaded data, pagination, caching responses, displaying error messages, and routing. Additionally, it includes Redux DevTools.

More Examples

You can find more examples in Awesome Reduxarrow-up-right.

Last updated