devrabiul/livewire-doctor

Automatically detect and fix common Livewire issues, with helpful commands and developer tools to streamline your Laravel development.

v1.0.0 2025-05-28 17:49 UTC

This package is auto-updated.

Last update: 2025-06-10 03:19:53 UTC


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.

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!