DEV Community

Cover image for 🩺 Fixing Livewire.js Not Loading — Meet `livewire-doctor` for Laravel
Rabiul Islam
Rabiul Islam

Posted on

🩺 Fixing Livewire.js Not Loading — Meet `livewire-doctor` for Laravel

#laravel #livewire #php #package

Have you ever opened your Laravel app, clicked a Livewire button… and nothing happened?
No console error. No network request. Just silence.

This usually means one thing:
Livewire.js is not loading — and debugging it can be frustrating.

That’s why I built livewire-doctor — a small but powerful Laravel package that diagnoses and solves Livewire JS loading issues and ensures your Livewire project is healthy.

🤕 The Pain: When Livewire Stops Working

It happens suddenly. You’re using Livewire, then one day:

  • wire:click stops responding
  • You can’t see livewire/livewire.js loading in DevTools
  • But no errors show up in the browser or terminal

And you're left wondering: "What broke?"

💊 The Cure: livewire-doctor

My package gives you instant visibility into the state of your Livewire setup. With a single command or browser visit, you'll know:

✅ If Livewire scripts and styles are loaded
✅ If required Blade directives are present
✅ If you’re missing any Livewire configurations
✅ If livewire/livewire.js is unreachable or failing to load

🚀 Installation

Install via Composer:

composer require devrabiul/livewire-doctor
Enter fullscreen mode Exit fullscreen mode

That’s it. No need to publish anything.

🩻 Usage

Run a full check from the terminal: 

php artisan livewire:doctor
Enter fullscreen mode Exit fullscreen mode

You’ll see output like this:

✔️  Livewire is installed
✔️  @livewireScripts directive found
✔️  livewire/livewire.js is accessible
✔️  Alpine.js detected
Enter fullscreen mode Exit fullscreen mode

Or…

❌ livewire/livewire.js is NOT loading
💡 Tip: Check your asset publishing, CSP, or script order
Enter fullscreen mode Exit fullscreen mode

You’ll get a clean web UI showing health checks for Livewire.

🧪 Why This Helps

This tool helps you:

  • Debug JS loading problems faster
  • Catch mistakes in Blade layout structure
  • Improve confidence when deploying to production
  • Confirm that Livewire is working even before you use components

It’s also useful in CI/CD pipelines to prevent broken Livewire setups from being deployed.

⚙️ Features

  • ✅ Zero configuration required
  • 🔍 Terminal + Web interface
  • ⚡ Lightweight and fast
  • 📦 Compatible with Laravel 8, 9, 10+
  • 🧠 Designed for Livewire v2 and v3

🤝 Open Source and Growing

You can find the package here:
👉 GitHub: devrabiul/livewire-doctor

If you like it, please:

  • ⭐ Star the repo
  • 🐞 Report issues
  • 💡 Suggest new checks
  • ✅ Share with Laravel friends

💬 Final Thoughts

Laravel Livewire is powerful — but fragile if scripts break silently.

livewire-doctor helps bring visibility, confidence, and speed to your Livewire development workflow.

Let’s stop guessing and start debugging with confidence.

🏷️ Tags

#Laravel #Livewire #PHP #Debugging #OpenSource #WebDev

Top comments (0)