README

Laravel starter kit preconfigured with React (Inertia.js),with a few tweaks like PHPStan, Rector, Pest, Pint, and Pail. Designed to give you a ready-to-use development environment for modern Laravel projects.

Features

✅ Laravel 12+
✅ Inertia.js for React integration
✅ PHPStan for static analysis
✅ Rector for automated code refactoring & upgrades
✅ Pest for testing
✅ Laravel Pint for code styling
✅ Pail for logging and monitoring queues
✅ SQLite database setup for fast local development
✅ Ready-to-use Composer scripts for automation

Installation

Create a new project using Composer:

composer create-project simaocurado/blank-tweaked-laravel-react-starter-kit my-app
cd my-app
npm install && npm run dev

The project will automatically:

Generate .env from .env.example
Generate an application key
Create database/database.sqlite
Run initial migrations
Copy phpstan.neon.dist to phpstan.neon

Development

Run the full development environment:

composer dev

For server-side rendering:

composer dev:ssr

Run tests with Pest:

composer test

Static Analysis & Refactoring

PHPStan (static analysis):

vendor/bin/phpstan analyse

Rector (automatic code refactoring):

vendor/bin/rector process app

Configuration

PHPStan config: phpstan.neon.dist → copied to phpstan.neon
Rector config: rector.php (already in root, no copy needed)

You can customize these files as needed.

Recommended Workflow

Create a project with Composer (create-project).
Run composer dev to start development environment.
Use vendor/bin/phpstan analyse and vendor/bin/rector process to maintain code quality.
Write tests with Pest and keep code formatted with Pint.

Requirements

PHP 8.2+
Composer 2.x
Node.js 18+ (for frontend assets)

Contributing

Contributions are welcome! Feel free to fork the repo, make improvements, and submit a pull request.

License

MIT License

simaocurado / blank-tweaked-laravel-react-starter-kit

Maintainers

Details