iquesters/user-management

A modular and extendable Laravel package that provides user management, role-based access control, and authentication features.

v1.0.19 2025-10-28 13:55 UTC

Requires

• php: >=8.1
• iquesters/foundation: ^1.0
• laravel/framework: ^10.0|^11.0|^12.0
• laravel/socialite: ^5.16
• spatie/laravel-permission: ^6.16

Requires (Dev)

• laravel/pint: ^1.0
• laravel/tinker: ^2.8

MIT

• Pritam Bag

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

1. Install the package using Composer:

composer require iquesters/user-management

1. Run migrations to create required database tables:

php artisan migrate

1. Seed:

php artisan user-management:seed

🔧 Configuration

The configuration file is published at config/user-management.php. You can override settings via this file or using .env variables.

Layouts

Control which Blade templates are used for auth pages and the main app:

USER_MANAGEMENT_AUTH_LAYOUT=usermanagement::layouts.package
USER_MANAGEMENT_APP_LAYOUT=usermanagement::layouts.app

• layout_auth → Layout used for login/register pages
• layout_app → Layout used for the main application

Logo

Set your application logo for auth pages:

USER_MANAGEMENT_LOGO=/images/logo.png

You can use:

• Full URL: https://example.com/logo.png
• Absolute path: /images/logo.png
• Package asset: img/logo.png
• Package namespace: usermanagement::img.logo.png

reCAPTCHA

Protect your forms using Google reCAPTCHA:

USER_MANAGEMENT_RECAPTCHA_SITE_KEY=your-site-key
USER_MANAGEMENT_RECAPTCHA_SECRET_KEY=your-secret-key

Google OAuth

Enable Google login or One Tap authentication:

USER_MANAGEMENT_GOOGLE_CLIENT_ID=your-client-id
USER_MANAGEMENT_GOOGLE_CLIENT_SECRET=your-client-secret
USER_MANAGEMENT_GOOGLE_REDIRECT_URI=https://your-app.com/auth/google/callback

Default Auth Behavior

Set default redirect routes and new user roles:

USER_MANAGEMENT_DEFAULT_AUTH_ROUTE=dashboard
USER_MANAGEMENT_DEFAULT_USER_ROLE=user

• default_auth_route → The route where users are redirected after login
• default_user_role → Default role for new users registering via Google OAuth