zacksmash/clean-af

The skeleton application for the Laravel framework.

v1.0.0 2025-08-27 01:18 UTC

Requires

• php: ^8.2
• inertiajs/inertia-laravel: ^2.0
• laravel/fortify: ^1.28
• laravel/framework: ^12.0
• laravel/tinker: ^2.10.1
• laravel/wayfinder: ^0.1.9

Requires (Dev)

• fakerphp/faker: ^1.23
• laravel/pail: ^1.2.2
• laravel/pint: ^1.24
• laravel/sail: ^1.41
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• pestphp/pest: ^4.0
• pestphp/pest-plugin-laravel: ^4.0

MIT

• framework
• laravel

README

• Minimal Tailwind styles, that can be completely removed in the app.css if you want.
• Uses Laravel Fortify to handle authentication, 2FA, etc.
• Uses Laravel Wayfinder for routing
• Intentially bare-bones so you can install whatever frontend you'd like without having to strip out existing components and structures.

Screenshots

Installation

Via Laravel Herd

One-click install a new application using this starter kit through Laravel Herd:

Via the Laravel Installer

Create a new Laravel application using this starter kit through the official Laravel Installer:

laravel new my-app --using=zacksmash/clean-af

Configuration

If you run into errors, you'll probably need to review the Laravel Fortify docs. This just a frontend starter kit, so nothing is configured for things like 2FA or Email Verification out of the box.

Email Verification

• Visit app/Models/User.php and implement the MustVerifyEmail interface.
• Visit app/Providers/FortifyServiceProvider.php and uncomment Fortify::verifyEmailView
• Visit config/fortify.php and uncomment Features::emailVerification()
• Visit resources/js/pages/auth/VerifyEmail.vue and uncomment the import

Two-Factor Authentication

• Visit app/Models/User.php and use the TwoFactorAuthenticatable trait
• Visit app/Providers/FortifyServiceProvider.php and uncomment Fortify::twoFactorChallengeView
• Visit config/fortify.php and uncomment Features::twoFactorAuthentication()
• Visit resources/js/pages/auth/TwoFactorChallenge.vue and uncomment the import
• Visit resources/js/pages/settings/TwoFactorAuth.vue and uncomment the imports
• Visit resources/js/pages/Dashboard.vue and uncomment the TwoFactorAuth import and component

Wayfinder Issues

If you run into Node error screens, you may need to compile the Wayfinder types again.

composer wayfinder

Other Helper Commands

Run ESLint

npm run lint

Run Pint

composer lint