PHPackages                             jeffersongoncalves/filament-refresh-sidebar - 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. jeffersongoncalves/filament-refresh-sidebar

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

jeffersongoncalves/filament-refresh-sidebar
===========================================

Automatically refresh the Filament sidebar navigation when certain events occur, ensuring menu items and badges are always up to date.

2.0.1(5mo ago)111.8k↓60.9%1MITBladePHP ^8.2CI passing

Since Dec 20Pushed 2w ago1 watchersCompare

[ Source](https://github.com/jeffersongoncalves/filament-refresh-sidebar)[ Packagist](https://packagist.org/packages/jeffersongoncalves/filament-refresh-sidebar)[ Docs](https://github.com/jeffersongoncalves/filament-refresh-sidebar)[ GitHub Sponsors](https://github.com/jeffersongoncalves)[ RSS](/packages/jeffersongoncalves-filament-refresh-sidebar/feed)WikiDiscussions 2.x Synced 2w ago

READMEChangelog (6)Dependencies (10)Versions (9)Used By (0)

[![Filament Refresh Sidebar](https://raw.githubusercontent.com/jeffersongoncalves/filament-refresh-sidebar/2.x/art/jeffersongoncalves-filament-refresh-sidebar.png)](https://raw.githubusercontent.com/jeffersongoncalves/filament-refresh-sidebar/2.x/art/jeffersongoncalves-filament-refresh-sidebar.png)

Filament Refresh Sidebar
========================

[](#filament-refresh-sidebar)

[![Latest Version on Packagist](https://camo.githubusercontent.com/a6f86831a126c97c1ed96ec14d9239ed010c80ed680a4123071fb7b42ad43b21/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a6566666572736f6e676f6e63616c7665732f66696c616d656e742d726566726573682d736964656261722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jeffersongoncalves/filament-refresh-sidebar)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/be7b708d03c0a7134c1a37c9f19485b40c59903d7ebdaa885eb33e61858e7870/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6a6566666572736f6e676f6e63616c7665732f66696c616d656e742d726566726573682d736964656261722f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d322e78266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/jeffersongoncalves/filament-refresh-sidebar/actions?query=workflow%3A%22Fix+PHP+code+styling%22+branch%3A2.x)[![Total Downloads](https://camo.githubusercontent.com/4734c73160b0f49c461c0aa36e3253ee57461596680ead0f0fc907441b4ddd55/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a6566666572736f6e676f6e63616c7665732f66696c616d656e742d726566726573682d736964656261722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jeffersongoncalves/filament-refresh-sidebar)[![License](https://camo.githubusercontent.com/00ee04623bfd9903ec4c01263ae3531c7fbe0b2b28053506485702a20cd002dc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6a6566666572736f6e676f6e63616c7665732f66696c616d656e742d726566726573682d736964656261722e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)

Description
-----------

[](#description)

**Filament Refresh Sidebar** is a lightweight plugin designed to keep your Filament sidebar navigation in sync. It's particularly useful when you have dynamic navigation badges or menu items that depend on database changes, ensuring the sidebar updates automatically without a full page reload.

Requirements
------------

[](#requirements)

- PHP 8.2 or higher
- Filament 5.0

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

[](#installation)

You can install the package via composer:

```
composer require jeffersongoncalves/filament-refresh-sidebar
```

Usage
-----

[](#usage)

Register the plugin in your Filament Panel Provider (typically `app/Providers/Filament/AdminPanelProvider.php`):

```
use JeffersonGoncalves\Filament\RefreshSidebar\RefreshSidebarPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ... other configuration
        ->plugins([
            RefreshSidebarPlugin::make(),
        ]);
}
```

### Automatic Refresh

[](#automatic-refresh)

The plugin automatically listens for database notifications via Laravel Echo (if configured) and triggers a sidebar refresh when a new notification is received.

### Manual Refresh

[](#manual-refresh)

You can also manually trigger a sidebar refresh from any Livewire component by dispatching the `refresh-sidebar` event:

```
$this->dispatch('refresh-sidebar');
```

This is useful for updating navigation badges after custom actions like creating, updating, or deleting records.

Development
-----------

[](#development)

You can run code analysis and formatting using the following commands:

```
# Run static analysis
composer analyse

# Format code
composer format
```

Changelog
---------

[](#changelog)

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

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

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Jèfferson Gonçalves](https://github.com/jeffersongoncalves)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

47

—

FairBetter than 93% of packages

Maintenance85

Actively maintained with recent releases

Popularity28

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 87.2% 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

Every ~26 days

Total

8

Last Release

58d ago

Major Versions

1.0.1 → 2.0.02026-02-16

1.0.2 → 2.0.12026-03-04

1.x-dev → 2.x-dev2026-06-20

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/411493?v=4)[Jefferson Gonçalves](/maintainers/jeffersongoncalves)[@jeffersongoncalves](https://github.com/jeffersongoncalves)

---

Top Contributors

[![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (34 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

---

Tags

filamentfilament-pluginrefresh-sidebarwebsocketlaravellivewirenavigationfilamentfilament-pluginjeffersongoncalvessidebarrefresh

###  Code Quality

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/jeffersongoncalves-filament-refresh-sidebar/health.svg)

```
[![Health](https://phpackages.com/badges/jeffersongoncalves-filament-refresh-sidebar/health.svg)](https://phpackages.com/packages/jeffersongoncalves-filament-refresh-sidebar)
```

###  Alternatives

[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3915.5k](/packages/rawilk-profile-filament-plugin)[backstage/mails

View logged mails and events in a beautiful Filament UI.

16429.7k](/packages/backstage-mails)[stephenjude/filament-two-factor-authentication

Filament Two Factor Authentication: Google 2FA + Passkey Authentication

85240.3k9](/packages/stephenjude-filament-two-factor-authentication)[croustibat/filament-jobs-monitor

Background Jobs monitoring like Horizon for all drivers for FilamentPHP

278359.3k12](/packages/croustibat-filament-jobs-monitor)[marcelweidum/filament-passkeys

Use passkeys in your filamentphp app

6758.2k2](/packages/marcelweidum-filament-passkeys)[relaticle/custom-fields

User Defined Custom Fields for Laravel Filament

16461.2k](/packages/relaticle-custom-fields)

PHPackages © 2026

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