What is React Scanner Studio? β
React Scanner Studio is a portable, interactive dashboard for analyzing React component usage across your codebase. It leverages react-scanner under the hood to scan your component data.
π View Screenshots | Live Demo
The Problem β
When working with large React codebases or design systems, you often need to answer questions like:
- Which components are most frequently used?
- What props are commonly passed to a component?
- Is our design system being adopted consistently?
- Which components might be candidates for deprecation?
While react-scanner provides powerful scanning capabilities and outputs detailed JSON data, interpreting that raw data can be tedious and time-consuming.
The Solution β
React Scanner Studio takes the JSON output from react-scanner and transforms it into a beautiful, interactive dashboard that makes it easy to:
- Visualize component usage β See at a glance which components are used most frequently
- Analyze prop patterns β Understand how components are being configured
- Share insights β Generate static HTML files that can be shared with anyone
- Track adoption β Monitor design system adoption across your codebase
How It Works β
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ
β β β β β β
β Your React ββββββΆβ react-scanner ββββββΆβ React Scanner β
β Codebase β β (JSON output) β β Studio (UI) β
β β β β β β
βββββββββββββββββββ βββββββββββββββββββ βββββββββββββββββββ- Initialize β The
initcommand creates a configuration file tailored to your project - Scan β The
scancommand (or automatic prompts) analyzes your codebase and generates a JSON report - Visualize β React Scanner Studio reads the report and displays an interactive dashboard
- Share β Build static files to host anywhere or share with your team
Key Features β
π Automatic Configuration β
The init command automatically creates a react-scanner.config.js file tailored to your project, so you can start scanning immediately.
π‘ Integrated Scanning β
The scan command wraps react-scanner with a beautiful CLI experience, automatically finding your config file and providing helpful output.
π Development Server β
The start command launches a local development server with hot reloading, perfect for exploring your component data during development.
π¦ Static Build β
The build command generates a portable, self-contained dashboard that can be:
- Hosted on GitHub Pages, Netlify, Vercel, or any static file server
- Shared via email or internal file sharing
- Archived for historical comparison
π§ CI/CD Integration β
Built-in support for continuous integration environments with the --ci flag, making it easy to generate reports as part of your build pipeline.
Prerequisites β
React Scanner Studio requires:
- Node.js 18.0 or higher
- react-scanner (automatically installed during
initif not present)
Future Plans β
React Scanner Studio currently leverages react-scanner for codebase analysis. We are developing our own scanning engine that will introduce additional capabilities:
- Deeper component analysis β Enhanced detection of component relationships, patterns, and hierarchies
- Performance insights β Identification of potential performance bottlenecks in component usage
- Smarter prop intelligence β More sophisticated prop pattern recognition and recommendations
- Framework-aware scanning β Optimized support for Next.js, Remix, and other React frameworks
- Incremental scanning β Faster scans by only analyzing changed files
React Scanner Studio will continue to support react-scanner for those who prefer it. The new engine will be an optional upgrade.
Follow our GitHub repository or join our Discord community for updates.
What's Next? β
- Installation Guide β Install React Scanner Studio
- Quick Start β Get up and running in 2 minutes
- CLI Commands β Explore all available commands
