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

1. Create a project with Composer (create-project).
2. Run composer dev to start development environment.
3. Use vendor/bin/phpstan analyse and vendor/bin/rector process to maintain code quality.
4. 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