Skip to content

LivewireDoctor: Your smart assistant for Laravel Livewire. Detects & auto-fixes issues like missing assets, bad directives & outdated components.

License

Notifications You must be signed in to change notification settings

devrabiul/livewire-doctor

Repository files navigation

🩺 LivewireDoctor – Fix Livewire Issues Instantly & Boost Productivity

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.

Latest Stable Version Total Downloads GitHub license GitHub Repo stars


📚 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


🤝 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:


LivewireDoctor is the smart way to keep your Laravel Livewire apps running at their best. Install it now — and let your code breathe easy!

About

LivewireDoctor: Your smart assistant for Laravel Livewire. Detects & auto-fixes issues like missing assets, bad directives & outdated components.

Topics

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages