Prerequisites

A working Filament v5 panel
crumbls/subscriptions already installed and migrated (see its installation guide)
PHP 8.3+, Laravel 11+

Install the package

composer require crumbls/subscriptions-filament

Composer pulls in crumbls/subscriptions ^2.0 as a transitive dependency if it isn't already present.

Register the plugin

In your panel provider (typically app/Providers/Filament/AdminPanelProvider.php):

use Crumbls\SubscriptionsFilament\SubscriptionsPlugin;

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

That's the entire integration. Reload your panel -- a "Subscriptions" navigation group appears with Plans, Features, and Subscriptions.

If you cache Filament components

If you've previously run php artisan filament:cache-components, clear the cache so Filament picks up the new resources:

php artisan filament:cache-components

Or delete bootstrap/cache/filament/panels/*.php and let it rebuild on next request.

Verify

Open the panel in a browser. You should see:

A "Subscriptions" group in the sidebar
Plans, Features, and Subscriptions listed under it
Empty list states (assuming you haven't seeded any data yet)

If you don't see them, the most common causes are:

Cached Filament components (clear the cache as above)
The plugin registration is in the wrong panel provider (you might have multiple panels)
A panel-level ->resources([...]) call that explicitly enumerates resources (overrides plugin registration)

What's next

Contributing

Thanks for your interest in contributing to crumbls/subscriptions-filament.

Local setup

git clone https://github.com/Crumbls/subscriptions-filament.git
cd subscriptions-filament
composer install

To hack on this package alongside the underlying crumbls/subscriptions package, add a path repository to your test app's composer.json:

{
    "repositories": [
        { "type": "path", "url": "../subscriptions" },
        { "type": "path", "url": "../subscriptions-filament" }
    ]
}

Pull requests

Open the PR against main.
Breaking changes belong behind a version bump — note them in CHANGELOG.md.
If the change affects what admins see, include a screenshot or screen recording.

Reporting issues

Open a GitHub issue with:

Affected version (composer show crumbls/subscriptions-filament).
crumbls/subscriptions version.
PHP, Laravel, and Filament versions.
Steps to reproduce.
Expected vs. actual behavior.

Security issues

Please do not open public issues for security vulnerabilities. See SECURITY.md for reporting channels.

Contributors

Thank you to everyone who has contributed to this package. Every pull request, bug report, and idea makes a difference.

chasecmiller

View on GitHub Sponsor this project

Subscriptions Filament