crumbls/subscriptions-filament is the Filament v5 admin UI for crumbls/subscriptions. One plugin registration, three resources appear under a "Subscriptions" navigation group, and you can manage plans, features, and subscriber subscriptions without writing any Filament code.
What you get
- Plans resource -- full CRUD, with collapsible trial and grace sections, currency picker, and translatable name/description
- Features resource -- standalone features with reset cycle config and a count of plans using each
- Subscriptions resource -- read-only list with inline Cancel and Renew actions, status badges (Active / Trial / Grace / Canceled / Ended)
- Plan -> Features relation manager -- attach existing features with per-plan values, create new ones inline, detach without deleting
- Plan -> Subscriptions relation manager -- view all subscriptions on a plan, create new ones, delete
- Drop-in subscriber relation manager -- add a subscriptions tab to any resource whose model uses
HasPlanSubscriptions
Requirements
| Package | PHP | Laravel | Filament | crumbls/subscriptions |
|---|---|---|---|---|
2.x |
8.3, 8.4 | 11.x, 12.x, 13.x | 5.x | ^2.0 |
Relationship to the parent package
This package is UI only. All business logic, models, events, and middleware live in crumbls/subscriptions. The Filament resources are thin wrappers that resolve their model classes through config('subscriptions.models'), so any extended model you've registered shows up here automatically.
You can use the parent package without this one. You cannot use this one without the parent package -- it's a hard dependency.
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/subscriptionsversion.- 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.