README

A modern Laravel starter kit with Livewire 4, Flux UI, and Fortify authentication pre-configured.

Stack

• Laravel 12 — PHP framework
• Livewire 4 — Reactive PHP components
• Flux UI — Component library for Livewire
• Fortify — Headless authentication
• Pest — Testing framework
• Pint — Code formatter
• Tailwind CSS v4 — Utility-first CSS

Features

• Authentication scaffolding (login, register, password reset, email verification, 2FA)
• Settings pages (profile, password, appearance, 2FA, delete account)
• Responsive sidebar layout with Flux UI components
• Dark mode support
• SPA-like navigation with Livewire's wire:navigate

Getting Started

1. Clone the repository
2. Copy .env.example to .env
3. Install dependencies:

   composer install
   npm install

4. Generate application key:

   php artisan key:generate

5. Run migrations:

   php artisan migrate

6. Seed the database (optional):

   php artisan db:seed

7. Build assets:

   npm run build

8. Start the development server:

   php artisan serve

Testing

php artisan test

Code Style

This project uses Pint for code formatting:

vendor/bin/pint

Project Structure

app/
├── Actions/Fortify/     # Fortify action classes
├── Livewire/            # Livewire components
├── Models/Core/         # Core models (User)
Providers/              # Service providers

resources/views/
├── components/         # Blade components
├── layouts/            # Layout files (app, auth, public)
├── pages/
│   ├── app/           # Authenticated app pages
│   ├── auth/          # Authentication pages
│   └── settings/      # Settings pages

Customization

• App Name: Update config/app.php or set APP_NAME in .env
• Layout: Edit resources/views/layouts/app.blade.php
• Navigation: Add items in the sidebar of app.blade.php

License

MIT