nunomaduro / laravel-starter-kit
The skeleton application for the Laravel framework.
Installs: 426
Dependents: 0
Suggesters: 0
Security: 0
Stars: 535
Watchers: 10
Forks: 63
Open Issues: 2
Language:Blade
Type:project
Requires
- php: ^8.4.0
- laravel/framework: ^12.31.1
- nunomaduro/essentials: ^1.0.1
Requires (Dev)
- driftingly/rector-laravel: ^2.0.7
- fakerphp/faker: ^1.24.1
- larastan/larastan: ^3.7.2
- laravel/boost: ^1.2.1
- laravel/pail: ^1.2.3
- laravel/pint: ^1.25.1
- mockery/mockery: ^1.6.12
- nunomaduro/collision: ^8.8.2
- pestphp/pest: ^4.1.0
- pestphp/pest-plugin-browser: ^4.1.0
- pestphp/pest-plugin-laravel: ^4.0.0
- pestphp/pest-plugin-type-coverage: ^4.0.2
- rector/rector: ^2.1.7
README
Laravel Starter Kit is an ultra-strict, type-safe Laravel skeleton engineered for developers who refuse to compromise on code quality. This opinionated starter kit enforces rigorous development standards through meticulous tooling configuration and architectural decisions that prioritize type safety, immutability, and fail-fast principles.
Why This Starter Kit?
Modern PHP has evolved into a mature, type-safe language, yet many Laravel projects still operate with loose conventions and optional typing. This starter kit changes that paradigm by enforcing:
- 100% Type Coverage: Every method, property, and parameter is explicitly typed
- Zero Tolerance for Code Smells: Rector and PHPStan at maximum strictness catch issues before they become bugs
- Immutable-First Architecture: Data structures favor immutability to prevent unexpected mutations
- Fail-Fast Philosophy: Errors are caught at compile-time, not runtime
- Automated Code Quality: Pre-configured tools ensure consistent, pristine code across your entire team
- Just Better Laravel Defaults: Thanks to Essentials / strict models, auto eager loading, immutable dates, and more...
This isn't just another Laravel boilerplate—it's a statement that PHP applications can and should be built with the same rigor as strongly-typed languages like Rust or TypeScript.
Getting Started
Requires PHP 8.4+.
Create your type-safe Laravel application using Composer:
composer create-project nunomaduro/laravel-starter-kit --prefer-dist example-app
Initial Setup
Navigate to your project and complete the setup:
cd example-app # Install PHP dependencies with optimized autoloader composer install # Install and build frontend assets npm install npm run build # Configure your environment cp .env.example .env php artisan key:generate # Run database migrations php artisan migrate # Start the development server composer dev
Optional: Browser Testing Setup
If you plan to use Pest's browser testing capabilities:
npm install playwright npx playwright install
Verify Installation
Run the test suite to ensure everything is configured correctly:
composer test
You should see 100% test coverage and all quality checks passing.
Available Tooling
Development
composer dev
- Starts Laravel server, queue worker, log monitoring, and Vite dev server concurrently
Code Quality
composer lint
- Runs Rector (refactoring), Pint (PHP formatting), and Prettier (JS/TS formatting)composer test:lint
- Dry-run mode for CI/CD pipelines
Testing
composer test:type-coverage
- Ensures 100% type coverage with Pestcomposer test:types
- Runs PHPStan at level 9 (maximum strictness)composer test:unit
- Runs Pest tests with 100% code coverage requirementcomposer test
- Runs the complete test suite (type coverage, unit tests, linting, static analysis)
Maintenance
composer update:requirements
- Updates all PHP and NPM dependencies to latest versions
License
Laravel Starter Kit was created by Nuno Maduro under the MIT license.