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.

🚀 Live Demo

👉 Try the Live Demo

💡 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

✨ 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: https://packages.rixetbd.com/devrabiul/livewire-doctor
• 🔗 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!