PHPackages                             enadstack/laravel-roles - 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. enadstack/laravel-roles

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

enadstack/laravel-roles
=======================

Reusable Roles & Permissions (single or multi-tenant teams) on spatie/laravel-permission

v1.3.6(4mo ago)0102MITPHPPHP >=8.2

Since Aug 28Pushed 4mo agoCompare

[ Source](https://github.com/Enadabuzaid/laravel-roles)[ Packagist](https://packagist.org/packages/enadstack/laravel-roles)[ RSS](/packages/enadstack-laravel-roles/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (6)Versions (16)Used By (0)

Laravel Roles
=============

[](#laravel-roles)

A reusable, multi-tenant, guard-aware ACL system for Laravel applications built on top of [spatie/laravel-permission](https://github.com/spatie/laravel-permission).

Features
--------

[](#features)

- Contract-based architecture with dependency injection
- Three tenancy modes: single, team-scoped, multi-database
- Guard-aware role and permission management
- Contextual caching (tenant, guard, locale aware)
- Permission matrix with efficient queries (no N+1)
- Diff-based permission sync with wildcard support
- Optional Vue UI (Inertia.js + shadcn-vue)
- Comprehensive artisan commands
- Full i18n support for labels and descriptions

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 12.0+
- spatie/laravel-permission 6.0+

Supported Tenancy Modes
-----------------------

[](#supported-tenancy-modes)

ModeDescription`single`Non-multi-tenant applications`team_scoped`Spatie's built-in team feature`multi_database`External providers (stancl/tenancy, etc.)Installation
------------

[](#installation)

```
composer require enadstack/laravel-roles
php artisan roles:install
php artisan roles:sync
```

Documentation
-------------

[](#documentation)

- [Installation](docs/installation.md)
- [Configuration](docs/configuration.md)
- [Tenancy](docs/tenancy.md)
- [Guards](docs/guards.md)
- [Roles](docs/roles.md)
- [Permissions](docs/permissions.md)
- [Permission Matrix](docs/permission-matrix.md)
- [Vue UI](docs/ui-vue.md)
- [API Reference](docs/api.md)
- [Caching](docs/caching.md)
- [Commands](docs/commands.md)
- [Testing](docs/testing.md)
- [Upgrading](docs/upgrading.md)
- [Troubleshooting](docs/troubleshooting.md)
- [Feature Roadmap](docs/features.md)

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for release history.

License
-------

[](#license)

MIT License. See [LICENSE](LICENSE) for details.

Credits
-------

[](#credits)

- [Enad Abuzaid](https://github.com/enadabuzaid)
- Built on [spatie/laravel-permission](https://github.com/spatie/laravel-permission)

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance74

Regular maintenance activity

Popularity13

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 87.5% 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 ~9 days

Recently: every ~0 days

Total

14

Last Release

142d ago

Major Versions

0.1.0 → v1.0.02025-10-13

### Community

Maintainers

![](https://www.gravatar.com/avatar/bbbfad3cf0066c54112eca980df0fddeeecf5fbd527dc747a2f689cdf204ff50?d=identicon)[Enadabuzaid](/maintainers/Enadabuzaid)

---

Top Contributors

[![Enadabuzaid](https://avatars.githubusercontent.com/u/49005097?v=4)](https://github.com/Enadabuzaid "Enadabuzaid (49 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (7 commits)")

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/enadstack-laravel-roles/health.svg)

```
[![Health](https://phpackages.com/badges/enadstack-laravel-roles/health.svg)](https://phpackages.com/packages/enadstack-laravel-roles)
```

###  Alternatives

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[althinect/filament-spatie-roles-permissions

340954.7k9](/packages/althinect-filament-spatie-roles-permissions)[illuminate/auth

The Illuminate Auth package.

9327.3M1.0k](/packages/illuminate-auth)[truckersmp/steam-socialite

Laravel Socialite provider for Steam OpenID.

1516.7k](/packages/truckersmp-steam-socialite)[pschocke/laravel-telegram-login-widget

Easily integrate Telegrams login widget into your Laravel application to send Telegram messages

1610.4k](/packages/pschocke-laravel-telegram-login-widget)

PHPackages © 2026

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