redux-devtools/README.md

48 lines
1.7 KiB
Markdown
Raw Normal View History

2015-07-14 22:46:44 +03:00
Redux DevTools
=========================
2015-07-15 00:45:02 +03:00
A better README is coming. But if you insist...
### Installation
It's out on NPM as `react-devtools@0.1.0`.
[This commit](https://github.com/gaearon/redux-devtools/commit/0a2a97556e252bfad822ca438923774bc8b932a4) should give you an idea about how to add Redux DevTools for your app **but make sure to only apply `devTools()` in development!** In production, this will be terribly slow because actions just accumulate forever. (We'll need to implement a rolling window for dev too.)
2015-07-15 00:15:04 +03:00
2015-07-15 00:32:47 +03:00
### Running Examples
2015-07-15 00:45:02 +03:00
You can do this:
2015-07-15 00:15:04 +03:00
```
git clone https://github.com/gaearon/redux-devtools.git
cd redux-devtools
npm install
cd examples/counter
npm install
npm start
open http://localhost:3000
```
2015-07-15 00:20:04 +03:00
Try clicking on actions in the log, or changing some code inside `examples/counter/reducers/counter`.
2015-07-15 00:15:04 +03:00
For fun, you can also open `http://localhost:3000/?debug_session=123`, click around, and then refresh.
2015-07-15 00:26:06 +03:00
2015-07-15 00:45:02 +03:00
Oh, and you can do the same with the TodoMVC example as well.
2015-07-15 00:32:47 +03:00
### It's Ugly!
The design or usability is not the point. (Although we'll have better design in the future :-)
2015-07-15 00:45:02 +03:00
**You can build a completely custom UI for it because `<DevTools>` accepts a `monitor` React component prop.** The included `LogMonitor` is just an example.
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.
### License
MIT