PHPackages                             rushing/laravel-react-component-registry - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. rushing/laravel-react-component-registry

ActiveLibrary[Utility & Helpers](/categories/utility)

rushing/laravel-react-component-registry
========================================

Laravel package for React component discovery, registration, and showcase functionality

00TypeScript

Since Sep 9Pushed 9mo agoCompare

[ Source](https://github.com/stephenr85/laravel-react-component-registry)[ Packagist](https://packagist.org/packages/rushing/laravel-react-component-registry)[ RSS](/packages/rushing-laravel-react-component-registry/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Laravel React Component Registry
================================

[](#laravel-react-component-registry)

A Laravel package for React component discovery, registration, and showcase functionality. Easily browse and explore React components in your Laravel application with a beautiful, shadcn/ui-based interface.

Features
--------

[](#features)

- 🔍 **Automatic Component Discovery** - Recursively scans configured directories for React components
- 🎨 **Beautiful UI** - Clean, responsive interface built with shadcn/ui components
- ⚙️ **Highly Configurable** - Customize routes, directories, templates, and more
- 🗃️ **Smart Caching** - Performance-optimized with configurable caching
- 📝 **Todo Tracking** - Extract and display TODO comments for component development tracking
- 🔧 **Props Documentation** - Automatically extract TypeScript prop definitions
- 🌍 **Environment Aware** - Disable in production environments automatically
- 🎯 **Laravel 12 Ready** - Built specifically for Laravel 12 with Inertia.js integration

Installation
------------

[](#installation)

Install the package via Composer:

```
composer require stephenr85/laravel-react-component-registry
```

Publish the configuration file:

```
php artisan vendor:publish --tag=config --provider="StephenR85\LaravelReactComponentRegistry\ComponentRegistryServiceProvider"
```

Optionally publish the views for customization:

```
php artisan vendor:publish --tag=views --provider="StephenR85\LaravelReactComponentRegistry\ComponentRegistryServiceProvider"
```

Configuration
-------------

[](#configuration)

Enable the component registry in your `.env` file:

```
COMPONENT_REGISTRY_ENABLED=true
```

Configure the package in `config/component-registry.php`:

```
return [
    'enabled' => env('COMPONENT_REGISTRY_ENABLED', false),
    'excluded_environments' => ['production'],
    'routes' => [
        'prefix' => 'dev/components',
        'middleware' => ['web'],
        'name_prefix' => 'component-registry.',
    ],
    'directories' => [
        'resources/js/components',
        'resources/js/pages',
    ],
    // ... more configuration options
];
```

Usage
-----

[](#usage)

Once configured, visit `/dev/components` (or your configured route prefix) to browse your React components.

### Component Discovery

[](#component-discovery)

The package will automatically discover React components (`.tsx` and `.jsx` files) in your configured directories. It extracts:

- Component names and descriptions
- TypeScript prop definitions
- TODO/FIXME comments for development tracking
- File metadata and organization

### Todo Tracking

[](#todo-tracking)

Add TODO comments in your components to track development progress:

```
// TODO: Add loading state handling
// TODO: Implement error boundaries
// FIXME: Performance optimization needed

export default function MyComponent() {
  // Component code
}
```

These will be automatically extracted and displayed in the component registry with a progress tracker.

### Facade Usage

[](#facade-usage)

You can also interact with the component registry programmatically:

```
use StephenR85\LaravelReactComponentRegistry\Facades\ComponentRegistry;

// Discover all components
$components = ComponentRegistry::discover();

// Find a specific component
$component = ComponentRegistry::findComponent('my-component');

// Clear the discovery cache
ComponentRegistry::clearCache();
```

Development Status
------------------

[](#development-status)

✅ **Task 1 Complete** - Package scaffolding and Laravel integration
🚧 **Task 2 In Progress** - Core component discovery service
⏳ **Task 3 Planned** - Route and controller implementation
⏳ **Task 4 Planned** - Template and view system
⏳ **Task 5 Planned** - Configuration and documentation

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 12.0+
- Inertia.js 2.0+

Testing
-------

[](#testing)

Run the package tests:

```
composer test
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance40

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity14

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/976179?v=4)[Stephen Rushing](/maintainers/stephenr85)[@stephenr85](https://github.com/stephenr85)

---

Top Contributors

[![stephenrprahsys](https://avatars.githubusercontent.com/u/194008910?v=4)](https://github.com/stephenrprahsys "stephenrprahsys (7 commits)")

### Embed Badge

![Health badge](/badges/rushing-laravel-react-component-registry/health.svg)

```
[![Health](https://phpackages.com/badges/rushing-laravel-react-component-registry/health.svg)](https://phpackages.com/packages/rushing-laravel-react-component-registry)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)