Laravel skeleton template Documentation

✨ Features

Authentication & Security

• Laravel Fortify - Powerful authentication scaffolding
• Two-Factor Authentication - Enhanced security with 2FA support
• Passkey Support - Modern WebAuthn authentication
• Email Change Confirmation - Secure email update workflow
• Route Labeling - Named route management
• Blacklist Protection - Email/IP blacklist capabilities

Frontend & UI

• Livewire 4 - Full-stack reactive Laravel components
• Tailwind CSS 4 - Modern utility-first CSS framework
• Blade Icons - Comprehensive icon system
• Vite - Next-generation frontend build tool
• Responsive Design - Mobile-first, production-ready UI

Development Experience

• Laravel Tinker - Interactive REPL for Laravel
• Laravel Debugbar - Powerful debugging toolkit
• Concurrent Development - Run multiple services simultaneously (server, queue, Vite)

Code Quality & Testing

Static Analysis

• PHPStan - Advanced PHP static analysis (Level 9)
• Rector - Automated code modernization
• Pint - Laravel code style fixer
• Duster - Comprehensive style checking

Testing

• PHPUnit 12 - Powerful PHP testing framework
• Paratest - Parallel test execution for faster CI/CD
• Mockery - Mocking library for tests
• Faker - Realistic testing data generation

Frontend Quality

• Prettier - Code formatter for JS, CSS, and Blade templates
• Stylelint - CSS linting and formatting
• Husky - Git hooks management
• Lint-staged - Run linters on staged files

📦 Requirements

• PHP ^8.3
• Node.js >=18.x
• Composer (latest)
• SQLite/PostgreSQL/MySQL (database)

1. Clone the Repository

git clone https://github.com/your-org/laravel-skeleton.git
cd laravel-skeleton

2. Install Dependencies

# Install PHP dependencies
composer install

# Install Node.js dependencies
npm install

3. Environment Configuration

# Copy environment file
cp .env.example .env

# Generate application key
php artisan key:generate

# Create SQLite database (if using SQLite)
touch database/database.sqlite

4. Database Setup

# Run migrations
php artisan migrate

# (Optional) Seed database with sample data
php artisan db:seed

5. Build Assets

# Development build with hot reload
npm run dev

# Production build
npm run build

📁 Project Structure

laravel-skeleton/
├── app/
│   ├── Actions/               # Action classes (Fortify actions)
│   ├── Http/
│   │   └── Controllers/       # HTTP controllers
│   ├── Models/                # Eloquent models
│   ├── Providers/             # Service providers
│   ├── View/
│   │   └── Components/        # Livewire & Blade components
│   └── helpers.php            # Global helper functions
├── bootstrap/                 # Bootstrap files
├── config/                    # Configuration files
├── database/
│   ├── factories/             # Model factories for testing
│   ├── migrations/            # Database migrations
│   └── seeders/               # Database seeders
├── public/                    # Public assets (compiled)
├── resources/
│   ├── css/                   # Tailwind CSS files
│   ├── js/                    # JavaScript files
│   ├── views/                 # Blade templates
│   └── svg/                   # SVG assets
├── routes/
│   ├── console.php            # Console commands
│   └── web.php                # Web routes
├── storage/                   # Logs, cache, uploads
├── tests/
│   ├── Feature/               # Feature tests
│   └── Unit/                  # Unit tests
├── composer.json              # PHP dependencies
├── package.json               # Node.js dependencies
└── vite.config.js             # Vite configuration

Testing & Quality Assurance

Run Tests

# Run full test suite
php artisan test

# Run tests in parallel
php artisan test --parallel

# Run specific test file
php artisan test tests/Feature/AuthTest.php

# Run with coverage
php artisan test --coverage

# Run only unit tests
php artisan test tests/Unit

# Run only feature tests
php artisan test tests/Feature

Code Quality & Formatting

# Run all quality checks
composer run test

# Format and fix code
composer run fix

# Only check types (PHPStan)
composer run test:types

# Modernize code with Rector
composer run test:refactor

# Format code with Pint
composer run pint

# Format frontend files
composer run prettier

# Fix style issues with Duster
./vendor/bin/duster fix

# Check for typos
composer run test:typos

# Generate PHPStan baseline
composer run phpstan-baseline

🔐 Authentication Features

• Email/Password Login - Standard authentication
• Email Verification - Confirm email addresses
• Two-Factor Authentication - SMS or authenticator app
• Passkeys - WebAuthn passwordless authentication
• Remember Me - Persistent login sessions
• Password Reset - Secure password recovery
• Email Change Confirmation - Verify new email addresses