PHPackages                             bitsoftsolutions/filament-reverb-doctor - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP &amp; Networking](/categories/http)
4. /
5. bitsoftsolutions/filament-reverb-doctor

ActiveLibrary[HTTP &amp; Networking](/categories/http)

bitsoftsolutions/filament-reverb-doctor
=======================================

A Filament 3.x plugin for Laravel Reverb Doctor - Visual dashboard for WebSocket diagnostics

v1.0.0(5mo ago)00MITPHPPHP ^8.1

Since Dec 8Pushed 5mo agoCompare

[ Source](https://github.com/hafizSiddiq7675/filament-reverb-doctor)[ Packagist](https://packagist.org/packages/bitsoftsolutions/filament-reverb-doctor)[ Docs](https://github.com/bitsoftsol/filament-reverb-doctor)[ RSS](/packages/bitsoftsolutions-filament-reverb-doctor/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (4)Versions (2)Used By (0)

Filament Reverb Doctor
======================

[](#filament-reverb-doctor)

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

[![Latest Version on Packagist](https://camo.githubusercontent.com/146af9157c021d6ab2207649bc323f281f4508d90d5baed72259fdde0609fd6d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626974736f6674736f6c7574696f6e732f66696c616d656e742d7265766572622d646f63746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bitsoftsolutions/filament-reverb-doctor)[![Total Downloads](https://camo.githubusercontent.com/3afdbe6fe99f8d6a39e022bd0ba9219f5445b1da014471dcf04de35c64099d81/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f626974736f6674736f6c7574696f6e732f66696c616d656e742d7265766572622d646f63746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bitsoftsolutions/filament-reverb-doctor)[![License](https://camo.githubusercontent.com/2c7566351d93c29db2c12d68864dacf54f8b7c7840a5fe076813b71f88af8fc9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f626974736f6674736f6c7574696f6e732f66696c616d656e742d7265766572622d646f63746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bitsoftsolutions/filament-reverb-doctor)

Features
--------

[](#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
-----------------

[](#diagnostic-checks)

The plugin runs 10 comprehensive checks:

CheckDescription**Reverb Installed**Verifies Laravel Reverb package is installed**Environment Variables**Checks all required REVERB\_\* env vars are set**Config Published**Ensures reverb.php config file exists**Broadcasting Driver**Validates BROADCAST\_CONNECTION is set to 'reverb'**App Config**Checks Reverb app configuration (id, key, secret)**Server Config**Validates server host and port settings**Queue Connection**Ensures queue connection is properly configured**SSL Configuration**Checks SSL/TLS settings consistency**Server Connectivity**Tests actual connection to Reverb server**Port Availability**Verifies configured port is not blockedRequirements
------------

[](#requirements)

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

Installation
------------

[](#installation)

Install the package via Composer:

```
composer require bitsoftsolutions/filament-reverb-doctor
```

The package will automatically install [laravel-reverb-doctor](https://github.com/bitsoftsol/laravel-reverb-doctor) as a dependency.

Setup
-----

[](#setup)

### 1. Register the Plugin

[](#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)

[](#2-publish-configuration-optional)

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

Usage
-----

[](#usage)

### Dashboard Page

[](#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

[](#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
-------------

[](#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
----------------------

[](#authorization-examples)

### Using Permissions (Spatie Permission)

[](#using-permissions-spatie-permission)

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

### Using Gates

[](#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

[](#using-custom-callback)

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

Screenshots
-----------

[](#screenshots)

### Dashboard Page

[](#dashboard-page-1)

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

### Dashboard Widget

[](#dashboard-widget-1)

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

CLI Alternative
---------------

[](#cli-alternative)

For command-line diagnostics, check out [Laravel Reverb Doctor](https://github.com/bitsoftsol/laravel-reverb-doctor):

```
php artisan reverb:doctor
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Contributions are welcome! Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security
--------

[](#security)

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

Credits
-------

[](#credits)

- [Hafiz Siddiq](https://github.com/hafizsiddiq)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance72

Regular maintenance activity

Popularity0

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 75% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

156d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4de51770e8f177b9df6dabac90967eec870b695b08d533cb65285c7cf6b94e2f?d=identicon)[hafizSiddiq7675](/maintainers/hafizSiddiq7675)

---

Top Contributors

[![BabarAslamm](https://avatars.githubusercontent.com/u/77414276?v=4)](https://github.com/BabarAslamm "BabarAslamm (3 commits)")[![hafizSiddiq7675](https://avatars.githubusercontent.com/u/29893550?v=4)](https://github.com/hafizSiddiq7675 "hafizSiddiq7675 (1 commits)")

---

Tags

pluginlaravelwebsocketdashboardfilamentdiagnosticshealth checkreverb

### Embed Badge

![Health badge](/badges/bitsoftsolutions-filament-reverb-doctor/health.svg)

```
[![Health](https://phpackages.com/badges/bitsoftsolutions-filament-reverb-doctor/health.svg)](https://phpackages.com/packages/bitsoftsolutions-filament-reverb-doctor)
```

###  Alternatives

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[pboivin/filament-peek

Full-screen page preview modal for Filament

253319.6k12](/packages/pboivin-filament-peek)[croustibat/filament-jobs-monitor

Background Jobs monitoring like Horizon for all drivers for FilamentPHP

254255.2k6](/packages/croustibat-filament-jobs-monitor)[guava/filament-modal-relation-managers

Allows you to embed relation managers inside filament modals.

7565.0k4](/packages/guava-filament-modal-relation-managers)[huang-yi/shadowfax

Run Laravel on Swoole.

3511.7k](/packages/huang-yi-shadowfax)[webplusm/gallery-json-media

a filament media storing in a Json field

196.0k](/packages/webplusm-gallery-json-media)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
