mamago11/laravel-starter-kit

The skeleton application starter kit for Laravel framework.

v1.0.0 2026-03-05 11:52 UTC

Requires

• php: ^8.5
• laravel/framework: ^12.0
• laravel/tinker: ^2.10.1

Requires (Dev)

• driftingly/rector-laravel: ^2.1
• fakerphp/faker: ^1.23
• larastan/larastan: ^3.9
• laravel/boost: ^2.0
• laravel/pail: ^1.2.2
• laravel/pint: ^1.27
• laravel/sail: ^1.53
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• pestphp/pest: ^4.4
• pestphp/pest-plugin-laravel: ^4.1
• pestphp/pest-plugin-type-coverage: ^4.0
• phpstan/phpstan: ^2.1
• rector/rector: ^2.3

MIT

• framework
• laravel
• starter-kit

README

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

Stack

Layer	Package	Version
Framework	Laravel	12
PHP	PHP	8.5
Database	MySQL	8.4
Frontend	Tailwind CSS	4
Bundler	Vite	7
Testing	Pest	4
Static Analysis	PHPStan + Larastan	2 / 3
Code Style	Laravel Pint	1
Refactoring	Rector	2
Development	Laravel Sail	1
Logging	Laravel Pail	1

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

Command	Description
composer run dev	Start server, queue worker, Pail log viewer, and Vite dev server concurrently
composer run test	Clear config cache and run the test suite
composer run analyse	Run Rector, Pint, and PHPStan in sequence
composer run rector	Run Rector automated refactoring
composer run pint	Run Laravel Pint code formatter
composer run stan	Run PHPStan static analysis
composer run setup	Full project setup from scratch

NPM

Command	Description
npm run dev	Start Vite dev server
npm run build	Build frontend assets for production

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