devrabiul / livewire-doctor
Automatically detect and fix common Livewire issues, with helpful commands and developer tools to streamline your Laravel development.
README
A powerful Laravel package that automatically diagnoses, fixes, and improves your Livewire development experience. Save time, eliminate headaches, and keep your components healthy β all with a single command.
π Table of Contents
π‘ Overview
LivewireDoctor is your personal development assistant for Laravel Livewire apps. It scans your project, detects common issues like missing assets, misconfigured directives, outdated components β and fixes them automatically.
Whether you're debugging, onboarding a team, or simply maintaining Livewire-based applications β this package keeps your workflow smooth and efficient.
β¨ Features at a Glance
- β Instantly diagnose common Livewire issues
- π οΈ Auto-fix configuration and structural problems
- βοΈ Artisan commands for one-click health checks
- π Scans for performance tips and improvements
- π§° Developer helpers for conditional debugging
- β‘ Optimized for Livewire v3
- π― Compatible with Laravel 10 & 11
π¦ Installation
Install via Composer:
composer require devrabiul/livewire-doctor
Optionally publish the config (if required later):
php artisan vendor:publish --provider="Devrabiul\LivewireDoctor\LivewireDoctorServiceProvider"
βοΈ Initialize Custom Assets in AppServiceProvider
You need to initialize custom Livewire assets initCustomAsset()
method in your AppServiceProvider
.
β Example:
<?php namespace App\Providers; use Illuminate\Support\ServiceProvider; use Devrabiul\LivewireDoctor\LivewireDoctor; class AppServiceProvider extends ServiceProvider { public function boot(): void { // Initializes LivewireDoctor custom asset setup LivewireDoctor::initCustomAsset(); } }
π Usage
π Run Health Checks
Scan your entire Livewire setup with a single command:
php artisan livewire:doctor
What it checks:
- Livewire installation and version
- Missing assets or directives
- Component structure, naming, and syntax validation
π Artisan Commands
Command | Description |
---|---|
php artisan livewire:doctor |
Run a full health check on your Livewire setup |
β¨ Why Developers Love LivewireDoctor
β βIt just works! Saved me hours of debugging Livewire component issues.β β βEvery Livewire project should start with
livewire:doctor
.β β βIncredible time-saver. One command, and my app is healthy again!β
π Useful Links
- π GitHub: Livewire Doctor Repository
- π Website: livewire-doctor.rixetbd.com
- π Packagist: https://packagist.org/packages/devrabiul/livewire-doctor
π€ Contributing
We welcome contributions to LivewireDoctor! If you would like to contribute, please fork the repository and submit a pull request. For any issues or feature requests, please open an issue on GitHub.
π License
Licensed under the MIT License.
π¬ Contact
For support, bugs, or feature suggestions:
- π§ Email: devrabiul@gmail.com
- π GitHub: @devrabiul
LivewireDoctor is the smart way to keep your Laravel Livewire apps running at their best. Install it now β and let your code breathe easy!