FortifyUI is an unopinionated authentication starter, powered by Laravel Fortify. This package can be used to start your project, or it can be forked to integrate your favorite frontend framework. It is completely unstyled on purpose and only includes a minimal amount of markup to get your project running quickly.
To get started, you'll need to install Laravel Fortify and follow the instructions to configure it. Next, install FortifyUI using Composer:
composer require zacksmash/fortify-ui
Next, publish FortifyUI's resources:
php artisan vendor:publish --provider="Zacksmash\FortifyUI\FortifyUIServiceProvider"
This command will publish FortifyUI's service provider to your app/Providers
directory. You should ensure this file is registered within the providers
array of your app
configuration file.
'providers' => [
...
App\Providers\FortifyServiceProvider::class,
App\Providers\FortifyUIServiceProvider::class,
],
If you'd rather not include the service provider file, you can publish just the required views to your project.
php artisan vendor:publish --provider="Zacksmash\FortifyUI\FortifyUIServiceProvider" --tag=views
Then, you can add this to Your AppServiceProvider
or FortifyServiceProvider
, in the boot()
method.
Fortify::loginView(function () {
return view('auth.login');
});
Fortify::registerView(function () {
return view('auth.register');
});
Fortify::requestPasswordResetLinkView(function () {
return view('auth.forgot-password');
});
Fortify::resetPasswordView(function ($request) {
return view('auth.reset-password', ['request' => $request]);
});
// Fortify::verifyEmailView(function () {
// return view('auth.verify');
// });
// Fortify::confirmPasswordView(function () {
// return view('auth.password-confirm');
// });
Now, you should have the required views for Laravel Fortify, including basic layout and home views, as well as optional password confirmation and email verification views.
Lastly, you should run the fortify-ui
command from the terminal:
php artisan fortify-ui
This will update your routes file with the home
route.
By default, FortifyUI is setup to handle the basic authentication functions (Login, Register, Password Reset) provided by Laravel Fortify.
To enable the email verification feature, you'll need to visit the FortifyUIServiceProvider
and uncomment the Fortify::verifyEmailView()
feature. Next, you'll need to follow the instructions from Laravel Fortify's documentation to update your User
model and the fortify.php
config file. This allows you to attach the verified
middleware to any of your routes, which is handled by the verify.blade.php
file.
To enable the password confirmation feature, you'll need to visit the FortifyUIServiceProvider
and uncomment the Fortify::confirmPasswordView()
feature. This allows you to attach the password.confirm
middleware to any of your routes, which is handled by the password-confirm.blade.php
file.
FortifyUI is open-sourced software licensed under the MIT license.