remote-redux-devtools

Remote Redux DevTools

Use Redux DevTools remotely for React Native, hybrid, desktop and server side Redux apps.

Installation

npm install --save-dev remote-redux-devtools

Usage

Just add our store enhancer to your store:

store/configureStore.js

import { createStore, applyMiddleware, compose } from 'redux';
import thunk from 'redux-thunk';
import devTools from 'remote-redux-devtools';
import reducer from '../reducers';

export default function configureStore(initialState) {
  const enhancer = compose(
    applyMiddleware(thunk),
    devTools()
  );
  // Note: passing enhancer as last argument requires redux@>=3.1.0
  const store = createStore(reducer, initialState, enhancer);
  // If you have other enhancers & middlewares
  // update the store after creating / changing to allow devTools to use them
  devTools.updateStore(store);
  return store;
}

Remote monitoring

Use one of our monitor apps to inspect and dispatch actions:

• web
• redux-devtools-extension - Click "Remote" button (or press Cmd+Ctrl+Arrow up) to open remote monitoring.
• remotedev-extension - Used in Electron/Browser DevTools panel.
• chrome app.
• react-native-debugger.
• remote-redux-devtools-on-debugger - Used in React Native debugger as a dock monitor.
• atom-redux-devtools - Used in Atom editor.
• redux-dispatch-cli - A CLI tool for Redux remote dispatch.

Use remotedev-app to create your own monitor app.

Communicate via local server

In order to make it simple to use, by default, the module and the monitor app communicate via remotedev.io server. Use remotedev-server cli to run it locally in order to make the connection faster and not to require an internet connection.

Parameters

Name	Description
name	String representing the instance name to be shown on the remote monitor.
realtime	Boolean specifies whether to allow remote monitoring. By default is process.env.NODE_ENV === 'development'.
hostname	String used to specify host for remotedev-server. If port is specified, default value is localhost.
port	Number used to specify host's port for remotedev-server.
secure	Boolean specifies whether to use https protocol for remotedev-server.
filters	Map of arrays named whitelist or blacklist to filter action types.
maxAge	Number of maximum allowed actions to be stored on the history tree, the oldest actions are removed once maxAge is reached. Default is 30.
startOn	String or Array of strings indicating an action or a list of actions, which should start remote monitoring (when realtime is false).
stopOn	String or Array of strings indicating an action or a list of actions, which should stop remote monitoring.
sendOn	String or Array of strings indicating an action or a list of actions, which should trigger sending the history to the monitor (without starting it). Note: when using it, add a fetch polyfill if needed.
sendOnError	Numeric code: 0 - disabled (default), 1 - send all uncaught exception messages, 2 - send only reducers error messages.
sendTo	String url of the monitor to send the history when sendOn is triggered. By default is ${secure ? 'https' : 'http'}://${hostname}:${port}.
actionCreators	Array or Object of action creators to dispatch remotely. See the example.
id	String to identify the instance when sending the history triggered by sendOn. You can use, for example, user id here, to know who sent the data.

All parameters are optional. You have to provide at least port property to use localhost instead of remotedev.io server.

Example:

export default function configureStore(initialState) {
  // Note: passing enhancer as last argument requires redux@>=3.1.0
  const store = createStore(
    rootReducer,
    initialState,
    devTools({
      name: 'Android app', realtime: true,
      hostname: 'localhost', port: 8000,
      maxAge: 30, filters: { blacklist: ['EFFECT_RESOLVED'] }
    })
  );
  // If you have other enhancers & middlewares
  // update the store after creating / changing to allow devTools to use them
  devTools.updateStore(store);
  return store;
}

Demo

• Toggle monitoring

Examples

• Web
• React Native

License

MIT