PHPackages a2zwebltd/nova-role-manager - 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. a2zwebltd/nova-role-manager ActiveLibrary[Authentication & Authorization](/categories/authentication) a2zwebltd/nova-role-manager =========================== A Laravel Nova tool for managing Spatie roles and permissions with optional audit logging. v1.1.0(1mo ago)1432↓45.5%MITPHPPHP ^8.2 Since Jan 26Pushed 1mo agoCompare [ Source](https://github.com/a2zwebltd/nova-role-manager)[ Packagist](https://packagist.org/packages/a2zwebltd/nova-role-manager)[ RSS](/packages/a2zwebltd-nova-role-manager/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (10)Versions (3)Used By (0) Laravel Nova Role Manager ========================= [](#laravel-nova-role-manager) [![Packagist Version](https://camo.githubusercontent.com/c29ed01c3f3b5542a4a6f698bd4d1b0d6648e4e115f3727d7304953c8bf19f7b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f61327a7765626c74642f6e6f76612d726f6c652d6d616e616765722e737667)](https://packagist.org/packages/a2zwebltd/nova-role-manager)[![Downloads](https://camo.githubusercontent.com/19991a13650f9f75f4a239e5d715416c526a931d98923fa9c96f6aa6416f82a0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f61327a7765626c74642f6e6f76612d726f6c652d6d616e616765722e737667)](https://packagist.org/packages/a2zwebltd/nova-role-manager)[![PHP](https://camo.githubusercontent.com/b5d4f7901c58ad1ddfff679966f426cc25a9354bab763846b9a7276c2feab4e0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253545382e322d626c7565)](https://camo.githubusercontent.com/b5d4f7901c58ad1ddfff679966f426cc25a9354bab763846b9a7276c2feab4e0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253545382e322d626c7565) A visual role and permission management tool for Laravel Nova. Built on Spatie's Laravel Permission package with automatic audit logging. [![Role Manager Interface](screenshots/Screenshot_2026-01-25_21-17-20.png)](screenshots/Screenshot_2026-01-25_21-17-20.png) Installation ------------ [](#installation) ``` composer require a2zwebltd/nova-role-manager ``` Quick Setup ----------- [](#quick-setup) ### 1. Register the Tool [](#1-register-the-tool) Add to `app/Providers/NovaServiceProvider.php`: ``` use A2ZWeb\NovaRoleManager\RoleManager; public function tools(): array { return [ new RoleManager, ]; } ``` ### 2. Add new menu item [](#2-add-new-menu-item) ``` MenuItem::make(__('Roles and Permissions Manager')) ->path('/role-manager') ``` ### 3. Done! [](#3-done) You can now add permissions with sections / groups like this: ``` Permission::create([ 'name' => 'viewPosts', 'group' => 'Content Management / Blogs', 'guard_name' => 'admin-dashboard', ]); ``` Demo Data (Optional) -------------------- [](#demo-data-optional) ### Demo roles and permissions [](#demo-roles-and-permissions) ``` php artisan db:seed --class="A2ZWeb\NovaRoleManager\Database\Seeders\RoleManagerDemoSeeder" ``` Demo data includes: - **admin** guard with 3 roles (Admin, Editor, Author) and basic CRUD permissions - **web** guard with 2 roles (Member, Contributor) and user-facing permissions - Examples of nested groups (`Blog / Posts`, `Management / Settings / General`) - Examples of ungrouped permissions (`Reports`, `Beta Features`) What's Included --------------- [](#whats-included) - **Visual Interface**: Table-based permission management across multiple roles - **Multi-Guard Support**: Manage permissions for different guards - **Permission Grouping**: Organize permissions by section/group - **Optional Audit Logging**: Track all role and permission changes (opt-in) - **Auditable Models**: Drop-in replacements for Spatie models with automatic audit tracking Configuration (Optional) ------------------------ [](#configuration-optional) Publish the config to customize behavior: ``` php artisan vendor:publish --tag=role-manager-config ``` ### Enabling Audit Logging [](#enabling-audit-logging) The package includes auditable models for automatic change tracking. To enable: **1. Set up Laravel Auditing:** ``` # Publish config and migration php artisan vendor:publish --tag=config --provider="OwenIt\Auditing\AuditingServiceProvider" php artisan vendor:publish --tag=migrations --provider="OwenIt\Auditing\AuditingServiceProvider" # Run migration php artisan migrate ``` **2. Use auditable models in `config/role-manager.php`:** ``` 'role_model' => \A2ZWeb\NovaRoleManager\Models\AuditableRole::class, 'permission_model' => \A2ZWeb\NovaRoleManager\Models\AuditablePermission::class, ``` **3. add a "View Audit Logs" button in `config/role-manager.php`** ``` 'enable_audit_logs' => true, ``` ### Permission Checks [](#permission-checks) Control who can edit roles: ``` 'edit_permission' => 'editRoles', // Set to null to allow all authenticated users 'view_audit_logs_permission' => 'viewAuditLogs', // Set to null to allow all ``` ### Permission Grouping [](#permission-grouping) For best organization, use forward slashes in the `group` field: ``` Permission::create([ 'name' => 'viewUsers', 'group' => 'Admin Dashboard / Users', 'guard_name' => 'admin', ]); ``` **Ungrouped Permissions:** Permissions without slashes or empty groups are placed in a catch-all category: ``` 'ungrouped_permissions_category' => 'Other', // Default category for ungrouped permissions // 'ungrouped_permissions_category' => null, // Set to null to hide ungrouped permissions ``` Advanced -------- [](#advanced) ### Custom Permission Repository [](#custom-permission-repository) Override how permissions are fetched: ``` 'permission_repository' => \App\Repositories\MyPermissionRepository::class, ``` Repository must have `allForGuard(string $guardName): Collection` method. ### Protected Roles [](#protected-roles) Prevent certain roles from being edited: ``` 'protected_roles' => [ 'SUPER_ADMIN', ], ``` ### Guard Display Order [](#guard-display-order) Control tab order: ``` 'guard_order' => [ 'admin-dashboard', 'user-dashboard', ], ``` Requirements ------------ [](#requirements) - Laravel 10, 11, 12, or 13 - Laravel Nova 5+ - Spatie Laravel Permission 5+ - PHP 8.2+ License ------- [](#license) MIT Security -------- [](#security) If you discover a security vulnerability, please email . Credits ------- [](#credits) - [A2Z Web](https://a2zweb.co) - [All Contributors](../../contributors) ### Health Score 44 — FairBetter than 92% of packages Maintenance90 Actively maintained with recent releases Popularity19 Limited adoption so far Community8 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 75% 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 Every ~61 days Total 2 Last Release 52d ago PHP version history (2 changes)v1.0.0PHP ^8.1 v1.1.0PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/2b500dd3d9b470b50b1ed911cd24a6fdcce51dd97dceb4f97879f727a14495a8?d=identicon)[dawid-makowski](/maintainers/dawid-makowski) --- Top Contributors [![makowskid](https://avatars.githubusercontent.com/u/6271194?v=4)](https://github.com/makowskid "makowskid (3 commits)")[![nikita-a2zweb](https://avatars.githubusercontent.com/u/201099482?v=4)](https://github.com/nikita-a2zweb "nikita-a2zweb (1 commits)") --- Tags laravellaravel-packagenovapermissionsroles-managementspatie-laravel-permissionspatielaravelauditingrolespermissionsrbacnova ### Embed Badge ![Health badge](/badges/a2zwebltd-nova-role-manager/health.svg) ``` [![Health](https://phpackages.com/badges/a2zwebltd-nova-role-manager/health.svg)](https://phpackages.com/packages/a2zwebltd-nova-role-manager) ``` ### Alternatives [spatie/laravel-permission Permission handling for Laravel 12 and up 12.9k89.8M1.0k](/packages/spatie-laravel-permission)[bezhansalleh/filament-shield Filament support for `spatie/laravel-permission`. 2.8k2.9M88](/packages/bezhansalleh-filament-shield)[hasinhayder/tyro Tyro - The ultimate Authentication, Authorization, and Role & Privilege Management solution for Laravel 12 & 13 6712.1k2](/packages/hasinhayder-tyro) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)