README

A beautiful Filament 3.x plugin that provides a visual dashboard for diagnosing Laravel Reverb WebSocket configuration issues.

Features

• Visual Dashboard: Beautiful Filament-native UI showing all diagnostic results
• Dashboard Widget: Quick health status widget for your Filament dashboard
• 10 Diagnostic Checks: Comprehensive checks inherited from Laravel Reverb Doctor
• Real-time Feedback: Loading states and notifications for better UX
• Fully Configurable: Customize navigation, authorization, and appearance
• Dark Mode Support: Seamless integration with Filament's dark mode

Diagnostic Checks

The plugin runs 10 comprehensive checks:

Requirements

• PHP 8.1+
• Laravel 10.x, 11.x, or 12.x
• Filament 3.x
• Laravel Reverb (for meaningful diagnostics)

Installation

Install the package via Composer:

composer require bitsoftsolutions/filament-reverb-doctor

The package will automatically install laravel-reverb-doctor as a dependency.

Setup

1. Register the Plugin

Add the plugin to your Filament Panel Provider:

// app/Providers/Filament/AdminPanelProvider.php

use Bitsoftsolutions\FilamentReverbDoctor\FilamentReverbDoctorPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ... other configurations
        ->plugin(FilamentReverbDoctorPlugin::make());
}

2. Publish Configuration (Optional)

php artisan vendor:publish --tag="filament-reverb-doctor-config"

Usage

Dashboard Page

Navigate to Reverb Health in your Filament admin panel sidebar (under the "System" group by default). Click the "Run Diagnostics" button to execute all checks.

Dashboard Widget

The plugin automatically adds a compact widget to your Filament dashboard showing quick health status. Click "Run Check" to execute diagnostics or "View Details" to go to the full dashboard.

Configuration

The published config file (config/filament-reverb-doctor.php) offers extensive customization:

return [
    /*
    |--------------------------------------------------------------------------
    | Navigation
    |--------------------------------------------------------------------------
    */
    'navigation' => [
        'enabled' => true,           // Show/hide from navigation
        'group' => 'System',         // Navigation group (null for no group)
        'icon' => 'heroicon-o-heart', // Heroicon name
        'sort' => 100,               // Sort order in navigation
        'label' => 'Reverb Health',  // Navigation label
    ],

    /*
    |--------------------------------------------------------------------------
    | Widget
    |--------------------------------------------------------------------------
    */
    'widget' => [
        'enabled' => true,  // Show/hide dashboard widget
        'sort' => 10,       // Widget sort order
    ],

    /*
    |--------------------------------------------------------------------------
    | Authorization
    |--------------------------------------------------------------------------
    */
    'authorization' => [
        // Require a specific permission
        'permission' => null, // e.g., 'view-reverb-doctor'

        // Use a gate for authorization
        'gate' => null, // e.g., 'viewReverbDoctor'

        // Custom callback
        'callback' => null, // e.g., [App\Policies\ReverbPolicy::class, 'viewDashboard']
    ],

    /*
    |--------------------------------------------------------------------------
    | Appearance
    |--------------------------------------------------------------------------
    */
    'appearance' => [
        'show_suggestions' => true, // Show fix suggestions column
        'show_details' => true,     // Show technical details
    ],
];

Authorization Examples

Using Permissions (Spatie Permission)

// config/filament-reverb-doctor.php
'authorization' => [
    'permission' => 'view-reverb-diagnostics',
],

Using Gates

// app/Providers/AuthServiceProvider.php
Gate::define('viewReverbDoctor', function ($user) {
    return $user->isAdmin();
});

// config/filament-reverb-doctor.php
'authorization' => [
    'gate' => 'viewReverbDoctor',
],

Using Custom Callback

// config/filament-reverb-doctor.php
'authorization' => [
    'callback' => function () {
        return auth()->user()?->email === 'admin@example.com';
    },
],

Screenshots

Dashboard Page

Full diagnostic dashboard showing all check results with status, messages, and suggestions.

Dashboard Widget

Compact widget showing quick health status with run/re-run functionality.

CLI Alternative

For command-line diagnostics, check out Laravel Reverb Doctor:

php artisan reverb:doctor

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Contributions are welcome! Please see CONTRIBUTING for details.

Security

If you discover any security-related issues, please email hafiz@bitsoftsolutions.com instead of using the issue tracker.

Credits

• Hafiz Siddiq
• All Contributors

License

The MIT License (MIT). Please see License File for more information.