happenv-com/filament-user-profile
Filament User Profile

This package draws inspiration from Filament Breezy. It does not implement two-factor authentication itself: its Two-Factor Authentication section shows the multi-factor authentication configured on your panel.
Rather than offering multiple plugin options, this package provides a streamlined approach to extending and replacing components.
Upgrading to 5.0
5.0 no longer requires spatie/laravel-passkeys; it is only suggested. The passkeys section is built on it, so
without the package the section is left out: it is neither registered with Livewire nor rendered, and the
filament-passkeys-scripts asset is not loaded. Nothing else changed.
If you use the passkeys section, require the package yourself so the upgrade does not remove it:
composer require spatie/laravel-passkeys
composer require happenv-com/filament-user-profile:^5.0
If your passkeys are Filament multi-factor authentication passkeys (for example
happenv-com/filament-passkeys), they are managed in the
two_factor_auth section, which renders every provider of $panel->multiFactorAuthentication([...]). You do not
need spatie/laravel-passkeys then; remove it if nothing else uses it.
Upgrading to 4.0
4.0 swaps the user agent parser again, this time to webard/agent — a maintained
fork of al-saloul/agent, which had not been released since January 2025 and emitted a PHP 8.4 deprecation on every
request that consumers could not suppress.
composer remove al-saloul/agent
composer require happenv-com/filament-user-profile:^4.0
The namespace is unchanged, so if you extended BrowserSessions your use Alsaloul\Agent\Agent; import keeps
working. webard/agent declares "replace": {"al-saloul/agent": "*"}, so remove the old package first — the two
cannot be installed side by side.
Nothing else changed; browser, platform and device detection behave exactly as in 3.x.
Upgrading to 3.0
3.0 raises the minimum PHP version to 8.3. The package previously declared ^8.2, but
its own test suite could never run there — pestphp/pest 4.x requires ^8.3 — so 8.2 was
untested. The CI matrix now covers 8.3 and 8.4 only.
The browser sessions component no longer depends on the abandoned jenssegers/agent
(and its outdated mobiledetect/mobiledetectlib 2.x). It now uses the maintained fork
al-saloul/agent.
If your application requires jenssegers/agent only because of this package, remove it:
composer remove jenssegers/agent
composer require happenv-com/filament-user-profile:^3.0
If you extended BrowserSessions and referenced the agent class, update the import:
-use Jenssegers\Agent\Agent;
+use Alsaloul\Agent\Agent;
The public API (browser(), platform(), isDesktop(), isMobile(), isTablet())
is unchanged, so no other changes are required.
Installation
To install the package, execute the following command:
composer require happenv-com/filament-user-profile
Register Plugin
To register the plugin, use the following code snippet:
use Happenv\FilamentUserProfile\UserProfilePlugin;
$panel->plugins([
UserProfilePlugin::make()
]);
Options
Register User Menu Item
Control whether the plugin should automatically register the user menu item:
UserProfilePlugin::make()
->registerUserMenu(false);
Custom Profile Page
Replace the entire ProfilePage with your custom component:
UserProfilePlugin::make()
->profilePage(MyProfileComponent::class);
Custom Profile Components
Manage the registered components and their order:
use Happenv\FilamentUserProfile\Livewire\PersonalInfo;
use Happenv\FilamentUserProfile\Livewire\UpdatePassword;
UserProfilePlugin::make()
->profileComponents([
'personal_info' => PersonalInfo::class,
'update_password' => UpdatePassword::class,
]);
Replace Profile Component
Replace a specific profile component:
use My\Component\PersonalInfo;
UserProfilePlugin::make()
->replaceProfileComponent('personal_info', PersonalInfo::class);
Register New Profile Component
Register a new profile component:
use My\Component\SomeComponent;
UserProfilePlugin::make()
->registerProfileComponent('some_component', SomeComponent::class);
Remove Profile Component
Remove a specific profile component:
use My\Component\SomeComponent;
UserProfilePlugin::make()
->removeProfileComponent('personal_info');
Laravel Sanctum
Laravel Sanctum is automatically detected, and a component to manage Sanctum tokens is displayed in the profile. Control the available abilities with the following code:
UserProfilePlugin::make()
->sanctumAbilities(['read', 'write']);
By default, all tokens are registered with all abilities ([*]).
Two-Factor Authentication
This package is compatible with stephenjude/filament-two-factor-authentication. Simply register the component as shown below:
UserProfilePlugin::make()
->registerProfileComponent('2fa', \Stephenjude\FilamentTwoFactorAuthentication\Livewire\TwoFactorAuthentication::class)
AI assistants (Laravel Boost)
The package ships a Laravel Boost skill, filament-user-profile-development, in resources/boost/skills/. php artisan boost:install (or boost:update) offers it to your coding agent: registering the page and the plugin, managing the section list, writing your own section on MyProfileComponent, avatars, and what each built-in section needs.
Related Packages
A complete and customizable User Avatar provider for your Filament project, and...
User & Role (via Spatie Roles/Permissions) Manager Resource For Filament Admin
Filament User model, UserResource, status-aware Login page and plugin for the je...
Version History
| Version | Released | PHP | License |
|---|---|---|---|
| v5.0.0 | ^8.3 | MIT | |
| v4.1.2 | ^8.3 | MIT | |
| v4.1.1 | ^8.3 | MIT | |
| v4.1.0 | ^8.3 | MIT | |
| v4.0.1 | ^8.3 | MIT | |
| v4.0.0 | ^8.3 | MIT | |
| v3.0.3 | ^8.3 | MIT | |
| v3.0.2 | ^8.3 | MIT | |
| v3.0.1 | ^8.3 | MIT | |
| v3.0.0 | ^8.2 | MIT |
Pre-releases (2)
| Version | Released | PHP | License |
|---|---|---|---|
| v2.0.1-beta | ^8.2 | MIT | |
| v2.0-beta | ^8.2 | MIT |