iquesters / user-management
A modular and extendable Laravel package that provides user management, role-based access control, and authentication features.
Requires
- php: ^8.3
- firebase/php-jwt: ^6.10|^7.0
- iquesters/foundation: ^2.0
- iquesters/user-interface: ^2.0
- laravel/framework: ^12.0|^13.0
- laravel/sanctum: ^4.0
- laravel/socialite: ^5.16
- spatie/laravel-permission: ^8.0
Requires (Dev)
- larastan/larastan: ^3.0
- laravel/pint: ^1.18
- orchestra/testbench: ^10.0|^11.0
Suggests
- iquesters/organisation: Organisation menu and the create-organisation onboarding step
Provides
None
Conflicts
None
Replaces
None
- dev-main
- v2.0.3
- v2.0.2
- v2.0.1
- v2.0.0
- v1.0.34
- v1.0.33
- v1.0.32
- v1.0.31
- v1.0.30
- v1.0.29
- v1.0.28
- v1.0.27
- v1.0.26
- v1.0.25
- v1.0.24
- v1.0.23
- v1.0.22
- v1.0.21
- v1.0.20
- v1.0.19
- v1.0.18
- v1.0.17
- v1.0.16
- v1.0.15
- v1.0.14
- v1.0.13
- v1.0.12
- v1.0.11
- v1.0.10
- v1.0.9
- v1.0.8
- v1.0.7
- v1.0.6
- v1.0.5
- v1.0.4
- v1.0.3
- v1.0.2
- v1.0.1
- v1.0.0
- dev-IQU-feature-business-entity
- dev-IQU-enhancement-profile-settings
- dev-IQU-security-open-redirect
- dev-IQU-enhancement-14
- dev-IQU-feat-12
- dev-IQU-docs-8
- dev-IQU-docs-5
- dev-IQU-docs-6
This package is auto-updated.
Last update: 2026-11-19 12:55:17 UTC
README
A robust and reusable User Management package for Laravel applications, developed and maintained by Iquesters.
This package provides authentication, role management, Google OAuth integration, and reCAPTCHA support. It also comes with configurable layouts, logos, and default behaviors for new users.
⚙️ Purpose
The User Management Package helps Laravel applications:
- Handle authentication and user roles
- Integrate Google login and One Tap authentication
- Customize login/register views with your own layout and branding
- Protect forms with reCAPTCHA
- Set default routes and roles for new users
It acts as a foundation for secure and modular user handling, which can be extended or used by other Iquesters packages.
🚀 Installation
- Install the package using Composer:
composer require iquesters/user-management
- Run migrations to create required database tables:
php artisan migrate
- Seed:
php artisan user-management:seed
App\Models\Useris updated automatically oncomposer install/update(package:discover): theHasUserManagementtrait is added anduid,phone,statusare made fillable. If your model has an unusual shape the installer prints what it couldn't do; the model then needs:
use Iquesters\UserManagement\Traits\HasUserManagement; // roles (spatie) + Sanctum tokens #[Fillable(['uid', 'name', 'email', 'password', 'phone', 'status'])] class User extends Authenticatable { use HasFactory, Notifiable, HasUserManagement; // with iquesters/organisation also: use \Iquesters\Organisation\Traits\HasOrganisations; }
Without this, registration fails with Field 'uid' doesn't have a default value.
- Don't create users in
DatabaseSeeder: any existing user makes first-run setup count as done. The first account registered after/setupbecomes the super-admin.
🔧 Configuration
Settings are stored in the database (not a config file or .env). php artisan user-management:seed writes the defaults.
See docs/developer/configuration.md for every key, including auth_form_type
(classic / schema / both auth forms), and docs/developer/social-login-configuration.md.