React Sight

React Sight is a live view of the component hierarchy tree of your React application with support for React Router and Redux.

We are currently working on squashing bugs related to fiber

Set Up | Install From Chrome Store

Make sure you've added React Dev Tools to Chrome.
Install React Sight from the Chrome web store
If you are running local file URLs, make sure to enable "Allow access to file URLs" in the extension settings for both React Dev Tools and React Sight
Run your React application, or open (almost!) any website running React!
Open Chrome Developer Tools (cmd+opt+j) -> React Sight panel

Building Your Own Version

If you'd like to build your own version of React Sight:

Clone the repo and npm install dependancies
Use npm start to generate the build
In Chrome, open the extensions tab and click 'Load Unpacked Extension'. Load the folder '~/ReactSight/chrome-ext'

If you have any additional questions send us a message at reactsight@gmail.com :)

Usage

Hover over nodes to see their state and props in the side panel.

Hide DOM elements, Redux components, and Router components with the built in filters, so that you can focus only on the components you've written

Zoom in by double clicking, and zoom out by shift + double clicking (mousewheel zoom coming soon!)

Why?

We built React Sight because there are no tools on the market that give you a visual representation of the structure of your App. When we were developing our own projects, we wished we had a way to see how everything was structured.

We wanted React Sight to be simple to use, which is why all you have to do is install a Chrome extension. No modifying your existing code!

Contributing

Found a bug? Have a suggestion?

Please submit issues/pull requests if you have feedback or would like to contribute. If you're interested in joining the React Sight team as a contributor, feel free to message one of us directly.

Authors

David C Sally (https://github.com/davidcsally)

Grant Kang (https://github.com/Grant05)

William He (https://github.com/hewilliam)

Contact

Like our app? Found a bug?

Tell us what you think!

reactsight@gmail.com

Visit us at www.reactsight.com

Roadmap

Here's our top development priorities

Better support across all React versions, especially fiber
More consistent detection of root nodes when React Sight is opened
Support for multiple React mounting nodes
More robust error handling and guard blocks for extracting state, props, and store
Logging / Debugging mode for development, feedback, and error reporting
Performance and stability updates
Mousewheel zoom in D3 chart (if you can solve this I will order you 🍕)
UX improvements
Improved documentation

License

This project is licensed under the MIT License - see the LICENSE.md file for details

vincevuong/React-Sight