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:

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

Included Packages

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.