Reactotron

A CLI and OS X app for inspecting your React JS and React Native apps.

Installing

Install CLI with NPM

npm install -g reactotron-cli

Install OS X application

Download OS X App from GitHub release and drop the Reactotron.app to the Applications folder.

Using Homebrew

Reactotron is also available via Homebrew Cask package manager. To ensure you get the latest version, update Homebrew first:

brew update

Then simply type:

brew cask install reactotron

About

Use it to:

view your application state
show API requests & responses
perform quick performance benchmarks
subscribe to parts of your application state
display messages similar to console.log
track global errors with source-mapped stack traces
dispatch actions like a government-run mind control experiment

You plug it into your app as a dev dependency so it adds nothing to your product builds.

The app comes in two forms:

Desktop

Reactotron on the left, demo React Native app on the right.

Command Line

Welcome to flavour country.

Quick Start

See the React JS Quick Start.
See the React Native Quick Start.

Usage

Track Errors
Integrate with Redux
Networking monitoring with Apisauce
Start making fetch happen (plugin coming soon...)
Creating Your Own Plugins (tutorial coming soon...)
The JSON interface between client & server (coming soon...)

Tips

Remote JS Debugging on Android

You'll need to turn of remote JS debugging as it hijacks the websocket channel between your app & Reactotron. I'm going to look into options. :|

Reverse Forwarding on Android

If you're running an android emulator and Android 5.x+ (or you're tethered on your device), then you'll need to forward port 9090 from your device back to your computer.

adb reverse tcp:9090 tcp:9090

Running in Production Builds

Although I don't recommend this for security & privacy reasons, you may actually want to run Reactotron in a production build (please please don't ship to the AppStore with it enabled. <3).

A few changes you'll need to make is to install Reactotron with --save instead of --save-dev. From there, you're good to go. But you also might want to consider calling Reactotron.connect() if you're in __DEV__ mode.

Here's a few us chatting about this subject:

infinitered#173

Special Thanks

Reactotron is sponsored by Infinite Red who encourage this type of open-source hacking & sharing. They specialize in React, React Native, and Elixir. <3

Change Log

About

A CLI and OS X app for inspecting your React JS and React Native apps.

MIT License

Languages

Language:JavaScript 94.8%Language:Objective-C 1.9%Language:CSS 0.8%Language:Shell 0.7%Language:Python 0.7%Language:HTML 0.6%Language:Java 0.5%