justchr1s/starter-kit

A modern Laravel starter kit with pre-configured tools for development, testing, linting, and refactoring to kickstart your projects quickly.

v0.1.0 2026-01-08 01:29 UTC

Requires

• php: ^8.4
• laravel/framework: ^12.0
• laravel/telescope: ^5.11
• laravel/tinker: ^2.10.1
• nunomaduro/essentials: ^0.1.0

Requires (Dev)

• barryvdh/laravel-ide-helper: ^3.6
• fakerphp/faker: ^1.23
• laradumps/laradumps: ^4.0
• larastan/larastan: ^3.6
• laravel/pail: ^1.2.2
• laravel/pint: ^1.24
• laravel/sail: ^1.41
• mockery/mockery: ^1.6
• nunomaduro/collision: ^8.6
• peckphp/peck: ^0.1.3
• pestphp/pest: ^4.1
• pestphp/pest-plugin-laravel: ^4.0
• pestphp/pest-plugin-type-coverage: ^4.0
• rector/rector: ^2.1

MIT

• framework
• laravel
• starter-kit

README

A modern Laravel 12 starter kit with pre-configured development tooling for building production-ready applications.

Features

• Concurrent development server — Laravel, queue, logs, and Vite in parallel
• Static analysis — PHPStan at level 10 (strictest)
• Type coverage — 100% type coverage enforced via Pest
• Automated refactoring — Rector with strict rulesets
• Code formatting — Laravel Pint with strict rules + Prettier
• Testing — Pest with parallel execution
• Debugging — Telescope and Laradumps pre-installed
• IDE support — Laravel IDE Helper for autocompletion

Requirements

• PHP 8.4+
• Composer 2.5+
• Node.js 18+
• npm 9+

Installation

Using the Laravel installer (recommended)

laravel new my-app --using justchr1s/starter-kit

Manual installation

git clone https://github.com/justchr1s/starter-kit.git my-app
cd my-app
composer setup

The composer setup command installs dependencies, configures the environment, runs migrations, and builds assets.

Note: This starter kit uses SQLite by default for simple local development.

Commands

Development

composer dev

Starts all development services concurrently:

• Laravel server (php artisan serve)
• Queue listener (php artisan queue:listen)
• Log watcher (php artisan pail)
• Vite (npm run dev)

Testing

composer test              # Run full test suite
composer test:unit         # Run Pest tests (parallel)
composer test:unit:coverage # Run tests with coverage report
composer test:types        # Run PHPStan analysis
composer test:type:coverage # Verify 100% type coverage
composer test:typos        # Check for typos with Peck
composer test:lint         # Check code style
composer test:refactor     # Preview Rector changes (dry-run)

Code Quality

composer lint      # Format code (Pint + Prettier)
composer refactor  # Apply Rector refactoring
composer fix       # Full fix: IDE helpers + types + refactor + lint

IDE Support

composer ide       # Generate IDE helper files

Code Standards

This starter kit enforces strict code quality:

Tool	Configuration
PHPStan	Level 10 (strictest)
Pest	100% type coverage required
Pint	Laravel preset with declare_strict_types, final_class, strict_comparison
Rector	deadCode, codeQuality, typeDeclarations, privatization, earlyReturn

All PHP files must have declare(strict_types=1) and classes should be final by default.

Included Packages

Package	Purpose
laravel/telescope	Debugging and monitoring
laradumps/laradumps	Real-time debugging
barryvdh/laravel-ide-helper	IDE autocompletion
laravel/pint	PHP code formatting
larastan/larastan	Static analysis
pestphp/pest	Testing framework
rector/rector	Automated refactoring
peckphp/peck	Typo detection

Contributing

Contributions are welcome. Please run composer test before submitting a pull request.

License

MIT License. See LICENSE for details.

Acknowledgements

Inspired by Josh Cirre's Fission.