Installation

Requirements

• PHP 8.2+
• Laravel 11, 12, or 13
• Filament v4 or v5

1. Install the package

composer require hexters/hexa

2. Run the migration

This creates the hexa_roles, hexa_role_user, and hexa_options tables.

php artisan migrate

3. Register the plugin

Add the plugin to your panel provider:

use Filament\Panel;
use Hexters\Hexa\Hexa;

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

4. Add the trait to your User model

use Hexters\Hexa\HexaRolePermission;

class User extends Authenticatable
{
    use HasFactory, Notifiable;
    use HexaRolePermission; // Add this trait
}

That's it. A Role & Permissions menu item will appear in your panel, and any user without a role is treated as a Superuser.

Next: Assigning Roles →