qisthidev/laravolt-starter-kit

The skeleton application for the Laravel framework.

v1.0.2 2025-12-27 05:24 UTC

Requires

• php: ^8.4.0
• laravel/framework: ^12.44.0
• nunomaduro/essentials: ^1.0.1

Requires (Dev)

• driftingly/rector-laravel: ^2.1.8
• fakerphp/faker: ^1.24.1
• larastan/larastan: ^3.8.1
• laravel/boost: ^1.8.7
• laravel/pail: ^1.2.4
• laravel/pint: ^1.26.0
• mockery/mockery: ^1.6.12
• nunomaduro/collision: ^8.8.3
• pestphp/pest: ^4.2.0
• pestphp/pest-plugin-browser: ^4.1.1
• pestphp/pest-plugin-laravel: ^4.0.0
• pestphp/pest-plugin-type-coverage: ^4.0.3
• rector/rector: ^2.2.14
• spaze/phpstan-disallowed-calls: ^4.7

MIT

• framework
• laravel
• laravolt

README

Laravolt Starter Kit

Personal Laravel starter kit with strict type-safety and code quality tools for Laravolt in Agentic era.

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 qisthidev/laravolt-starter-kit --prefer-dist example-app

Initial Setup

Navigate to your project and complete the setup:

cd example-app

# Setup project
composer setup

# 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 Pest
• composer test:types - Runs PHPStan at level 9 (maximum strictness)
• composer test:unit - Runs Pest tests with 100% code coverage requirement
• composer 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

Based on nunomaduro/laravel-starter-kit.