README

An opinionated Laravel 12 starter kit with a pre-configured development toolchain for building robust, type-safe applications.

Stack

Requirements

• Docker & Docker Compose (for Sail)

Getting Started

composer run setup

This will install dependencies, generate the app key, run migrations, and build frontend assets.

To start the full development environment (server, queue, logs, Vite HMR):

composer run dev

Or with Sail:

./vendor/bin/sail up -d
./vendor/bin/sail composer run dev

Available Scripts

Composer

NPM

Toolchain Configuration

PHPStan (phpstan.neon)

• Level: 6
• Larastan extension enabled for Laravel-aware analysis
• Paths analysed: app/, routes/, database/
• Extra checks: uninitialized properties, missing callable signatures, PHPDoc types treated as certain

Pint (pint.json)

• Preset: laravel
• Additional rules: strict types declaration, short array syntax, fully qualified imports, explicit string variables, aligned multiline comments

Rector (rector.php)

• PHP target: 8.5
• Laravel sets: code quality, collections, facade aliases to full names, Eloquent query builder, factories, container string to FQCN, array/string helpers to static calls
• Prepared sets: dead code removal, code quality, coding style, type declarations, privatization, early return

Pest (tests/)

• Plugins: pest-plugin-laravel, pest-plugin-type-coverage
• PHPUnit 12 under the hood

Docker (Sail)

• App container: PHP 8.5
• Database: MySQL 8.4
• A separate testing database is automatically created by the MySQL entrypoint script
• Xdebug support via SAIL_XDEBUG_MODE environment variable

License

MIT