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(4mo ago)4475.0k↓10.7%85MITPHPPHP ^8.2CI passing

Since Jun 14Pushed 4w 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 1w ago

READMEChangelog (10)Dependencies (8)Versions (22)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.x5.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

Popularity44

Moderate usage in the ecosystem

Community24

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 56.1% 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 ~68 days

Total

22

Last Release

28d 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 (37 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (17 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

3131.2M25](/packages/ysfkaya-filament-phone-input)[awcodes/filament-quick-create

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

249203.6k11](/packages/awcodes-filament-quick-create)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3913.7k](/packages/rawilk-profile-filament-plugin)[dotswan/filament-map-picker

Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications.

127173.7k3](/packages/dotswan-filament-map-picker)[stephenjude/filament-feature-flags

Filament implementation of feature flags and segmentation with Laravel Pennant.

122157.7k1](/packages/stephenjude-filament-feature-flags)[creagia/filament-code-field

A Filamentphp input field to edit or view code data.

57301.3k3](/packages/creagia-filament-code-field)

PHPackages © 2026

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