PHPackages                             helios-live/filament-feature-showcase - 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 &amp; Helpers](/categories/utility)
4. /
5. helios-live/filament-feature-showcase

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

helios-live/filament-feature-showcase
=====================================

A Filament plugin that displays a beautiful version changelog modal with an always-accessible 'What's New' button.

v1.3.0(1w ago)51.3k↑86.7%3[1 issues](https://github.com/helios-live/filament-feature-showcase/issues)MITBladePHP ^8.1

Since Apr 6Pushed 1w agoCompare

[ Source](https://github.com/helios-live/filament-feature-showcase)[ Packagist](https://packagist.org/packages/helios-live/filament-feature-showcase)[ Docs](https://github.com/helios-live/filament-feature-showcase)[ RSS](/packages/helios-live-filament-feature-showcase/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (7)Versions (6)Used By (0)

Filament Feature Showcase
=========================

[](#filament-feature-showcase)

A beautiful Filament plugin that displays a version changelog modal with an always-accessible "What's New" button. Keep your users informed about new features with an elegant, accordion-style changelog.

Features
--------

[](#features)

- Auto-show modal when a new version is released
- Accordion-style changelog showing all versions (newest first)
- Persistent floating "What's New" button with unseen version indicator
- Version label in the sidebar footer
- Fully configurable via a publishable config file
- Dark mode support
- Respects your Filament theme colors

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

[](#installation)

```
composer require helios-live/filament-feature-showcase
```

Setup
-----

[](#setup)

### 1. Register the plugin

[](#1-register-the-plugin)

Add the plugin to your `AdminPanelProvider`:

```
use HeliosLive\FilamentFeatureShowcase\FeatureShowcasePlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugin(FeatureShowcasePlugin::make());
}
```

### 2. Publish the config

[](#2-publish-the-config)

```
php artisan vendor:publish --tag=filament-feature-showcase-config
```

### 3. Add to your theme

[](#3-add-to-your-theme)

The plugin's Tailwind classes need to be included in your Filament theme. Add the following `@source` directive to your theme CSS file (usually `resources/css/filament/admin/theme.css`):

```
@source '../../../../vendor/helios-live/filament-feature-showcase/resources/**/*.blade.php';
```

Then rebuild your theme:

```
npm run build
```

### 4. User model requirement

[](#4-user-model-requirement)

Your `User` model must have a JSON column to store the last seen version (defaults to `preferences`). The column must be cast to `array`:

```
protected $casts = [
    'preferences' => 'array',
];
```

If you don't have one, create a migration:

```
php artisan make:migration add_preferences_to_users_table
```

```
Schema::table('users', function (Blueprint $table) {
    $table->json('preferences')->nullable();
});
```

You can use a different column name by setting `user_column` in the config.

Configuration
-------------

[](#configuration)

Edit `config/filament-feature-showcase.php` to define your versions and features:

```
return [
    'current' => '1.2.0',

    'user_column' => 'preferences',

    'preference_key' => 'last_seen_version',

    'dismiss_route' => '/admin/dismiss-version-showcase',

    'changelog' => [
        '1.2.0' => [
            'title' => 'Dark Mode Support',
            'description' => 'Full dark mode support across the platform.',
            'features' => [
                [
                    'icon' => 'heroicon-o-moon',
                    'title' => 'Dark Mode',
                    'description' => 'Toggle between light and dark themes.',
                ],
            ],
        ],

        '1.1.0' => [
            'title' => 'Search Improvements',
            'description' => 'Find what you need faster.',
            'features' => [
                [
                    'icon' => 'heroicon-o-magnifying-glass',
                    'title' => 'Global Search',
                    'description' => 'Search across all resources instantly.',
                ],
            ],
        ],
    ],
];
```

Plugin Options
--------------

[](#plugin-options)

```
FeatureShowcasePlugin::make()
    ->showSidebarVersion(true)     // Show version in sidebar footer (default: true)
    ->showButton(true)             // Show the floating "What's New" button (default: true)
    ->buttonPosition('bottom-left') // Button position: bottom-left, bottom-right, top-left, top-right
```

Translations
------------

[](#translations)

The package UI strings are translatable using Laravel's localization system.

You may publish the translation files with:

```
php artisan vendor:publish --tag=filament-feature-showcase-translations
```

This will publish the package language files so you can customize labels such as the modal title, version badge, action buttons, and helper text.

For example, after publishing the translations, you may edit the Spanish file:

```
lang/vendor/filament-feature-showcase/es/messages.php

```

Depending on your Laravel version, the file may also be published under:

```
resources/lang/vendor/filament-feature-showcase/es/messages.php

```

### Translating changelog entries

[](#translating-changelog-entries)

Changelog values are also passed through Laravel's `__()` helper when rendered.

This means you can keep using plain strings:

```
'changelog' => [
    '1.2.0' => [
        'title' => 'Dark Mode Support',
        'description' => 'Full dark mode support across the platform.',
        'features' => [
            [
                'icon' => 'heroicon-o-moon',
                'title' => 'Dark Mode',
                'description' => 'Toggle between light and dark themes.',
            ],
        ],
    ],
],
```

Or you can use translation keys:

```
'changelog' => [
    '1.2.0' => [
        'title' => 'changelog.versions.1_2_0.title',
        'description' => 'changelog.versions.1_2_0.description',
        'features' => [
            [
                'icon' => 'heroicon-o-moon',
                'title' => 'changelog.versions.1_2_0.features.dark_mode.title',
                'description' => 'changelog.versions.1_2_0.features.dark_mode.description',
            ],
        ],
    ],
],
```

Then define those translations in your application, for example:

```
// lang/es/changelog.php

return [
    'versions' => [
        '1_2_0' => [
            'title' => 'Compatibilidad con modo oscuro',
            'description' => 'Compatibilidad completa con modo oscuro en toda la plataforma.',
            'features' => [
                'dark_mode' => [
                    'title' => 'Modo oscuro',
                    'description' => 'Alterna entre temas claros y oscuros.',
                ],
            ],
        ],
    ],
];
```

How It Works
------------

[](#how-it-works)

1. When a user logs in, the plugin checks their `last_seen_version` preference against `config('filament-feature-showcase.current')`
2. If the versions don't match, the modal auto-opens showing the latest version's features
3. Clicking "Got it, let's go!" marks the version as seen
4. The floating sparkles button is always available to re-open the changelog
5. All versions are shown in a collapsible accordion, newest first

License
-------

[](#license)

MIT

###  Health Score

47

—

FairBetter than 93% of packages

Maintenance94

Actively maintained with recent releases

Popularity28

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 61.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 ~18 days

Total

4

Last Release

9d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/09dbf787c0b3936d92194a12ebd68b7c54b8a4f10616e7c665c3ea651e0cada8?d=identicon)[helios-live](/maintainers/helios-live)

---

Top Contributors

[![alexandru-eftimie](https://avatars.githubusercontent.com/u/65734304?v=4)](https://github.com/alexandru-eftimie "alexandru-eftimie (8 commits)")[![emmaferdez](https://avatars.githubusercontent.com/u/78182998?v=4)](https://github.com/emmaferdez "emmaferdez (5 commits)")

---

Tags

changelogfilament-pluginfilamentphplaravelwhats-newlaravelversionfilamentchangelogfeature-showcasewhats-new

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/helios-live-filament-feature-showcase/health.svg)

```
[![Health](https://phpackages.com/badges/helios-live-filament-feature-showcase/health.svg)](https://phpackages.com/packages/helios-live-filament-feature-showcase)
```

###  Alternatives

[ysfkaya/filament-phone-input

A phone input component for Laravel Filament

3131.2M25](/packages/ysfkaya-filament-phone-input)[rawilk/profile-filament-plugin

Profile &amp; 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)[jibaymcs/filament-tour

Bring the power of DriverJs to your Filament panels and start a tour !

12351.0k](/packages/jibaymcs-filament-tour)

PHPackages © 2026

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