README

A reusable, multi-tenant, guard-aware ACL system for Laravel applications built on top of spatie/laravel-permission.

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

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

Supported Tenancy Modes

Installation

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

Documentation

• Installation
• Configuration
• Tenancy
• Guards
• Roles
• Permissions
• Permission Matrix
• Vue UI
• API Reference
• Caching
• Commands
• Testing
• Upgrading
• Troubleshooting
• Feature Roadmap

Changelog

See CHANGELOG.md for release history.

License

MIT License. See LICENSE for details.

Credits

• Enad Abuzaid
• Built on spatie/laravel-permission