Weave Code
Usher Laravel Package
maatwebsite/usher
Maatwebsite Usher is a Laravel/PHP package for user authentication and authorization, offering a foundation for managing users and access control. It integrates with Laravel to help implement secure login and permission handling in applications.
Doctrine ACL for Laravel 5
Frequently asked questions about Usher
- What is Maatwebsite Usher used for in Laravel?
- Usher is a lightweight Laravel package for streamlining how new users are brought into an application, from invitation through to an active account. It is intended to remove the need to hand-wire that onboarding flow while staying out of the way of your existing auth stack. It follows Laravel conventions and includes config, Artisan scaffolding, events, notifications, and Blade view hooks.
- How do I install Maatwebsite Usher?
- Install it with Composer using composer require maatwebsite/usher. The service provider is auto-discovered, so no manual provider registration is required. After installation, publish the package config and use the provided Artisan commands to scaffold the pieces your app needs.
- Does Usher replace Laravel Breeze, Jetstream, Fortify, or my existing authentication?
- No. Usher is designed to stay out of the way of your existing auth stack and focuses on the invitation-to-active-account onboarding flow. You can keep your current Laravel authentication setup and use Usher for the onboarding layer. It leans on Laravel conventions rather than replacing them.
- How do I customize Usher's invitation and onboarding flow?
- Usher ships with a publishable config file that lets you tailor the flow to your application. You can also use its Artisan commands to scaffold the required pieces before adapting them. Because the package follows Laravel conventions, customization should feel familiar to Laravel developers.
- Can I override Usher's invitation and onboarding Blade views?
- Yes. Usher provides overridable Blade views for invitations and onboarding. You can publish or override those views following Laravel's normal view customization approach. Check the package documentation for the exact publish tags and view paths.
- Which Laravel versions does Maatwebsite Usher support?
- The provided overview does not list specific Laravel version constraints. Because Usher is a Laravel-native package, you should confirm compatibility in the repository's composer.json and README before installing. Composer will also enforce the package's declared framework constraints during installation.
- How does Usher integrate with Laravel events and notifications?
- Usher exposes Laravel-native events and notification hooks around the invitation and onboarding flow. That lets you listen for package events and customize notifications using Laravel's existing event and notification systems. You should review the package's events and notification classes to decide what to hook into.
- How should I test Usher's invitation-to-active-account flow?
- Test it like any other Laravel onboarding flow, using Laravel's testing tools to cover invitation creation, acceptance, and account activation. Usher's Laravel-native events and notifications hooks can help you assert that the expected lifecycle steps fired. Keep tests focused on your app's configuration and overridden views, since those are the parts most likely to change.
- Is Maatwebsite Usher suitable for production Laravel applications?
- Usher is a lightweight package that uses Laravel conventions and an auto-discovered service provider, which makes it straightforward to evaluate for production. Before shipping, review the published config, notification delivery, and any overridden Blade views, and test the full invitation-to-active-account flow. Also confirm the package's version constraints and maintenance status for your Laravel version.
- How do I check whether Maatwebsite Usher is maintained and up to date?
- Check the GitHub repository for recent commits, releases, and open issues, and review the Composer metadata for supported Laravel and PHP versions. The overview provided here does not include a maintenance guarantee, so those repository signals are the reliable source. Pin a compatible version in composer.json and review upgrades before deploying.
Weaver
How can I help you explore Laravel packages today?