PHPackages                             awcodes/filament-versions - 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. [Utility & Helpers](/categories/utility)
4. /
5. awcodes/filament-versions

ActivePackage[Utility & Helpers](/categories/utility)

awcodes/filament-versions
=========================

A mostly useless package to display framework versions at the bottom of the navigation panel.

v4.0.0(6mo ago)4476.5k↓13.4%85MITPHPPHP ^8.2CI passing

Since Jun 14Pushed 3d ago1 watchersCompare

[ Source](https://github.com/awcodes/filament-versions)[ Packagist](https://packagist.org/packages/awcodes/filament-versions)[ GitHub Sponsors](https://github.com/awcodes)[ RSS](/packages/awcodes-filament-versions/feed)WikiDiscussions 4.x Synced 3w ago

READMEChangelog (10)Dependencies (8)Versions (23)Used By (5)

Versions
========

[](#versions)

A mostly useless package to display framework versions at the bottom of the Filament Admin navigation panel and an optional widget to do the same in the dashboard or custom pages.

[![Latest Version](https://camo.githubusercontent.com/1ec68d9dff71f3a8b736c405473d99dbe73045ec4a398d6bec006662e2ac540a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6177636f6465732f66696c616d656e742d76657273696f6e732e7376673f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d52656c65617365)](https://github.com/awcodes/filament-versions/releases)[![MIT Licensed](https://camo.githubusercontent.com/a7e65aee57b11d28e4caff8b945729a66be0bb663f7f93bd24c5aa65699f148e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/2c9122d172af011481efed702dba550310063641a2756817f641868129f93be3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6177636f6465732f66696c616d656e742d76657273696f6e732e7376673f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d446f776e6c6f616473)](https://packagist.org/packages/awcodes/filament-versions)[![GitHub Repo stars](https://camo.githubusercontent.com/c7715398d59ab39ec232da3bb9fa4ea48f988351be665271b5f6f4b91feccd4b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6177636f6465732f66696c616d656e742d76657273696f6e733f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d5374617273)](https://github.com/awcodes/filament-versions/stargazers)

Compatibility
-------------

[](#compatibility)

Package VersionFilament Version1.x2.x2.x3.x3.x4.x4.x4.x & 5.xInstallation
------------

[](#installation)

Install the package via composer

```
composer require awcodes/filament-versions
```

Important

If you have not set up a custom theme and are using Filament Panels follow the instructions in the [Filament Docs](https://filamentphp.com/docs/4.x/styling/overview#creating-a-custom-theme) first.

After setting up a custom theme add the plugin's views to your theme css file.

```
@source '../../../../vendor/awcodes/filament-versions/resources/**/*.blade.php';
```

Usage
-----

[](#usage)

Register the plugin and/or Widget in your Panel provider:

```
use Awcodes\Versions\VersionsPlugin;
use Awcodes\Versions\VersionsWidget;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            VersionsPlugin::make(),
        ])
        ->widgets([
            VersionsWidget::class,
        ]);
}
```

Note

If you are using the `topNavigation` option with your panel the sidebar widget will show up at the bottom of your pages content.

Disabling Navigation View
-------------------------

[](#disabling-navigation-view)

If you'd like to disable the navigation view and only use the dashboard widget you may do passing `false` or a Closure to the `hasNavigationView` method.

```
use Awcodes\Versions\VersionsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            VersionsPlugin::make()
                ->hasNavigationView(false),
        ]);
}
```

Custom Items
------------

[](#custom-items)

You can add custom items to the widgets by creating a new class that implements the `VersionProvider` interface.

```
use Awcodes\Versions\Providers\Contracts\VersionProvider;

class MyCustomVersionProvider implements VersionProvider
{
    public function getName(): string
    {
        return 'My Custom Version';
    }

    public function getVersion(): string
    {
        return '1.0.0';
    }
}
```

Then add the item to the plugin:

```
use Awcodes\Versions\VersionsPlugin;
use App\Filament\Providers\MyCustomVersionProvider;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            VersionsPlugin::make()
                ->items([
                    new MyCustomVersionProvider(),
                ]),
        ]);
}
```

Disabling the default items
---------------------------

[](#disabling-the-default-items)

You can disable the default items by passing `false` or a Closure to the `hasDefaultItems` method.

```
use Awcodes\Versions\VersionsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            VersionsPlugin::make()
                ->hasDefaults(false)
        ]);
}
```

Widget options
--------------

[](#widget-options)

You can change the column span and order of the widget by setting them on the plugin.

```
use Awcodes\Versions\VersionsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            VersionsPlugin::make()
                ->widgetColumnSpan('full')
                ->widgetSort(2),
        ]);
}
```

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)

- [Adam Weston](https://github.com/awcodes)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

59

—

FairBetter than 98% of packages

Maintenance86

Actively maintained with recent releases

Popularity43

Moderate usage in the ecosystem

Community24

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 57.5% 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 ~70 days

Recently: every ~80 days

Total

22

Last Release

25d ago

Major Versions

v1.1.1 → v2.0.0-alpha12023-07-04

v2.0.1 → v3.0.0-beta.12025-06-12

2.x-dev → 3.x-dev2026-01-12

3.x-dev → v4.0.02026-01-19

PHP version history (3 changes)v1.0.0PHP ^8.0.2

v2.0.0-alpha1PHP ^8.1

v3.0.0-beta.1PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3596800?v=4)[Adam Weston](/maintainers/awcodes)[@awcodes](https://github.com/awcodes)

---

Top Contributors

[![awcodes](https://avatars.githubusercontent.com/u/3596800?v=4)](https://github.com/awcodes "awcodes (42 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (19 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (9 commits)")[![gergo85](https://avatars.githubusercontent.com/u/2959112?v=4)](https://github.com/gergo85 "gergo85 (2 commits)")[![alexjustesen](https://avatars.githubusercontent.com/u/1144087?v=4)](https://github.com/alexjustesen "alexjustesen (1 commits)")

---

Tags

filamentfilament-pluginlaravelversionspluginsfilamentawcodes

###  Code Quality

TestsPest

Static AnalysisRector

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/awcodes-filament-versions/health.svg)

```
[![Health](https://phpackages.com/badges/awcodes-filament-versions/health.svg)](https://phpackages.com/packages/awcodes-filament-versions)
```

###  Alternatives

[ysfkaya/filament-phone-input

A phone input component for Laravel Filament

3161.3M26](/packages/ysfkaya-filament-phone-input)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3914.8k](/packages/rawilk-profile-filament-plugin)[awcodes/filament-curator

A media picker plugin for FilamentPHP.

437356.9k24](/packages/awcodes-filament-curator)[backstage/mails

View logged mails and events in a beautiful Filament UI.

16121.5k](/packages/backstage-mails)[stephenjude/filament-feature-flags

Filament implementation of feature flags and segmentation with Laravel Pennant.

123177.8k1](/packages/stephenjude-filament-feature-flags)[awcodes/filament-quick-create

Plugin for Filament Admin that adds a dropdown menu to the header to quickly create new items.

249220.8k12](/packages/awcodes-filament-quick-create)

PHPackages © 2026

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