davidecariola/scaffolding-fortify-bootstrap

Automatically creates a Laravel 8 scaffolding with Laravel/Fortify and Bootstrap 5

dev-main 2021-09-27 12:10 UTC

Requires

• php: ^7.3|^8.0
• illuminate/support: ~7|~8
• laravel/fortify: 2.x-dev
• laravel/socialite: ^5.0

MIT

• Davide Cariola

• bootstrap
• auth
• laravel
• fortify

README

Latest version on Packagist

This package was created to allow developers to focus on the code that really matters. Installing Laravel Fortify and Bootstrap 5 can take a long time and many steps which, with this package, are reduced to a simple line of code. Just install Scaffolding Fortify Bootstrap and you're ready to code right away!

Specifically, it will:

• install Laravel/Fortify Package
• install Laravel/Socialite Package
• install bootstrap 5, popperjs/core
• update resources/app.js and resources/app.css
• run npm install && npm run dev
• create components folder in resources/views with layout file
• create auth folder in resources/views with login, register, forgot-password and reset-password files in it
• every user related view will already have a complete form with csrf token, methods, actions, validation errors and session messages
• create a controller named SocialiteController which manages authentication with Google

Requirements

• PHP >= 8.0.0
• Laravel >= 8.0.0

Installation

To get started, install package using composer:

composer require davidecariola/scaffolding-fortify-bootstrap

Next, run install artisan command to publish scaffolding:

php artisan sfb:install

Publish Laravel Fortify:

php artisan vendor:publish --provider="Laravel\Fortify\FortifyServiceProvider"

Add in config/app.php, in providers[] array:

App\Providers\FortifyServiceProvider::class,
Laravel\Socialite\SocialiteServiceProvider::class,

Add in config/app.php, in aliases[] array:

'Socialite' => Laravel\Socialite\Facades\Socialite::class,

Make sure the following are enabled in config\fortify.php, in features[]:

Features::registration(),
Features::resetPasswords(),
Features::updateProfileInformation(),
Features::updatePasswords(),
Features::twoFactorAuthentication([
        'confirmPassword' => true,
]),

Add in app\Providers\FortifyServiceProvider, in boot() function:

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]);
});

Remember to update const HOME in app\Providers\RouteServiceProvider:

public const HOME = '/';

In .env file, link your smtp service (like Mailtrap) and update sender.

In app\config\services.php, update google[] with your identification data.

In .env file, insert the same google keys you inserted in services.php:

GOOGLE_CLIENT_ID=YOUR_GOOGLE_CLIENT_ID
GOOGLE_CLIENT_SECRET=YOUR_GOOGLE_CLIENT_SECRET
GOOGLE_REDIRECT=http://localhost:8000/callback

After creating the database, create a new migration to add google_id field in the users table:

php artisan make:migration add_google_id_column_to_users_table

Then proceed to set 'google_id' as a string in the migration.

Add 'google_id' in app\Models\User, in fillable[].

When you're ready:

php artisan migrate

Build something amazing!!

Usage

Just install this package and begin coding without worries!

What's next?

I will cover every Laravel/Fortify possibility, like TwoFactorAuthentication.

License

This package is open-sourced software licensed under the MIT license

Credits

Thanks to Leonardo De Candia and Roberto Russo for awesome support!