DevTools for Redux with hot reloading, action replay, and customizable UI
Go to file
2016-02-12 17:27:55 -06:00
docs Extract Walkthrough.md doc 2016-01-29 20:39:28 +00:00
examples Remove unused import 2016-01-28 19:17:17 +00:00
src clarify comment 2016-02-10 10:52:12 -06:00
test clean up currentStateIndex tests 2016-02-12 17:27:55 -06:00
.babelrc Use es2015-loose and react babel presets 2015-12-14 17:18:34 -06:00
.eslintignore Add project skeleton (no DevTools yet) 2015-07-14 22:46:44 +03:00
.eslintrc Import the initial devTools implementation 2015-07-15 00:09:54 +03:00
.gitignore We don't need an UMD build here 2015-07-15 00:09:20 +03:00
.travis.yml Update .travis.yml 2015-12-13 00:03:58 +00:00
CHANGELOG.md Update CHANGELOG.md 2015-08-26 20:13:18 +03:00
CODE_OF_CONDUCT.md Add project skeleton (no DevTools yet) 2015-07-14 22:46:44 +03:00
LICENSE.md Add project skeleton (no DevTools yet) 2015-07-14 22:46:44 +03:00
package.json 3.1.0 2016-02-02 18:09:30 +00:00
README.md Update README.md 2016-01-29 20:44:26 +00:00

Redux DevTools

A live-editing time travel environment for Redux.
See Dan's React Europe talk demoing it!

build status npm version npm downloads redux channel on discord

Features

  • Lets you inspect every state and action payload
  • Lets you go back in time by “cancelling” actions
  • If you change the reducer code, each “staged” action will be re-evaluated
  • If the reducers throw, you will see during which action this happened, and what the error was
  • With persistState() store enhancer, you can persist debug sessions across page reloads

Overview

Redux DevTools is a development time package that provides power-ups for your Redux development workflow. Be careful to strip its code in production! To use Redux DevTools, you need to choose a “monitor”—a React component that will serve as a UI for the DevTools. Different tasks and workflows require different UIs, so Redux DevTools is built to be flexible in this regard. We recommend using LogMonitor for inspecting the state and time travel, and wrap it in a DockMonitor to quickly move it across the screen. That said, when youre comfortable rolling up your own setup, feel free to do this, and share it with us.

Chrome Extension

If you dont want to bother with installing Redux DevTools and integrating it into your project, consider using Redux DevTools Chrome Extension. It provides access to the most popular monitors, is easy to configure to filter actions, and doesnt require installing any packages.

Walkthrough

Read the walkthrough for the integration instructions.

Running Examples

Clone the project:

git clone https://github.com/gaearon/redux-devtools.git
cd redux-devtools

Run npm install in the root folder:

npm install

Now you can open an example folder and run npm install there:

cd examples/counter # or examples/todomvc
npm install

Finally, run the development server and open the page:

npm start
open http://localhost:3000

Try clicking on actions in the log, or changing some code inside the reducers. You should see the action log re-evaluate the state on every code change.

Also try opening http://localhost:3000/?debug_session=123, click around, and then refresh. You should see that all actions have been restored from the local storage.

Custom Monitors

DevTools accepts monitor components so you can build a completely custom UI. LogMonitor and DockMonitor are just examples of what is possible.

I challenge you to build a custom monitor for Redux DevTools!

Some crazy ideas for custom monitors:

  • A slider that lets you jump between computed states just by dragging it
  • An in-app layer that shows the last N states right in the app (e.g. for animation)
  • A time machine like interface where the last N states of your app reside on different Z layers
  • Feel free to come up with and implement your own! Check LogMonitor propTypes to see what you can do.

In fact some of these are implemented already:

Slider Monitor

Diff Monitor

Filterable Log Monitor

redux-devtools-filterable-log-monitor

Chart Monitor

redux-devtools-chart-monitor

Filter Actions

(Does not have a UI but can wrap any other monitor)

Keep them coming!

Create a PR to add your custom monitor.

License

MIT