PHPackages                             afea/filament-users - 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. [Authentication & Authorization](/categories/authentication)
4. /
5. afea/filament-users

ActiveLibrary[Authentication & Authorization](/categories/authentication)

afea/filament-users
===================

User management module for the Afea Filament CMS package ecosystem: user listing/editing, role management and permission assignment backed by spatie/laravel-permission.

v0.1.0(1mo ago)014↑445.5%MITPHPPHP ^8.4

Since Apr 21Pushed 1mo agoCompare

[ Source](https://github.com/AfeaSoftware/filament-users)[ Packagist](https://packagist.org/packages/afea/filament-users)[ RSS](/packages/afea-filament-users/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (11)Versions (2)Used By (0)

afea/filament-users
===================

[](#afeafilament-users)

User management module for the Afea Filament CMS package ecosystem.

Ships:

- `UserResource` — list/create/edit users with role attachment
- `RoleResource` — list/create/edit roles with permission assignment (checkbox list)
- `SuperAdminRoleSeeder` — idempotent seed for the `super_admin` role
- `UsersPlugin` + `afea:install:users` installer

Wraps **`spatie/laravel-permission`** which is already required by `afea/filament-cms-core` — this package just adds the Filament admin UI and lifecycle commands.

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

[](#installation)

```
composer require afea/filament-users
php artisan afea:install:users
```

Then add the `HasRoles` trait to your `App\Models\User`:

```
use Illuminate\Foundation\Auth\User as Authenticatable;
use Spatie\Permission\Traits\HasRoles;

class User extends Authenticatable
{
    use HasRoles;
    // ...
}
```

Register in `AdminPanelProvider`:

```
->plugin(\Afea\Cms\Users\Filament\UsersPlugin::make())
```

Grant yourself the super-admin role:

```
php artisan tinker
>>> App\Models\User::first()->assignRole('super_admin')
```

Three common scenarios
----------------------

[](#three-common-scenarios)

### 1. Use a different User subclass

[](#1-use-a-different-user-subclass)

```
AFEA_USERS_USER_MODEL="App\\Models\\AdminUser"
```

Or set the full config key:

```
// config/afea-users.php
'models' => [
    'user' => \App\Models\AdminUser::class,
],
```

### 2. Seed domain-specific permissions

[](#2-seed-domain-specific-permissions)

Create your own seeder alongside `SuperAdminRoleSeeder`:

```
namespace Database\Seeders;

use Spatie\Permission\Models\Permission;

class PermissionSeeder extends \Illuminate\Database\Seeder
{
    public function run(): void
    {
        collect(['view_posts', 'create_posts', 'edit_posts', 'delete_posts'])
            ->each(fn ($name) => Permission::findOrCreate($name, 'web'));
    }
}
```

Then call `php artisan db:seed --class=Database\\Seeders\\PermissionSeeder`.

### 3. Filament Shield — auto-generated policies

[](#3-filament-shield--auto-generated-policies)

`bezhansalleh/filament-shield` is a first-class companion. Install it *before* running our installer and we auto-run `shield:install` + `shield:generate --all` for you:

```
composer require bezhansalleh/filament-shield
php artisan afea:install:users --force
```

The installer detects Shield via the `shield:install` Artisan command, asks for confirmation, and passes the configured panel id (default `admin`, change with `--panel-id=cms`). The `super_admin` role we seed matches Shield's convention, so existing accounts keep working.

If you install Shield *after* running our installer, just run Shield's commands manually:

```
php artisan shield:install admin
php artisan shield:generate --all --panel=admin
```

Skip Shield with `--skip-shield` even when it is installed (useful for CI).

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance90

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

49d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/090664afed2a3f014aa9cc4d2225925052fbc30e1995ebb9898272dc77a5b45f?d=identicon)[ahmetozrahat](/maintainers/ahmetozrahat)

---

Top Contributors

[![ahmetozrahat](https://avatars.githubusercontent.com/u/12434217?v=4)](https://github.com/ahmetozrahat "ahmetozrahat (2 commits)")

---

Tags

laravelcmsrolespermissionsUsersfilamentafea

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/afea-filament-users/health.svg)

```
[![Health](https://phpackages.com/badges/afea-filament-users/health.svg)](https://phpackages.com/packages/afea-filament-users)
```

###  Alternatives

[spatie/laravel-permission

Permission handling for Laravel 12 and up

12.9k98.0M1.3k](/packages/spatie-laravel-permission)[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k3.5M115](/packages/bezhansalleh-filament-shield)[laravel/ai

The official AI SDK for Laravel.

9782.1M153](/packages/laravel-ai)[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[chiiya/filament-access-control

Admin user, role and permission management for Laravel Filament

21851.1k](/packages/chiiya-filament-access-control)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3913.7k](/packages/rawilk-profile-filament-plugin)

PHPackages © 2026

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