# Code Style Guidelines — PHP / Laravel

- **Formatter:** Laravel Pint (runs `./vendor/bin/pint`)
- **Standard:** PSR-12
- **Indentation:** 4 spaces (no tabs)
- **Line Length:** Max 120 characters per line
- **PHP Version:** 8.1+ — use typed properties, enums, match expression, named arguments
- **Strict types:** Always declare `declare(strict_types=1)` at top of every file
- **Complexity:** Methods should do one thing only. Max ~30 lines; use Services/Actions for complex logic
- **Comments:** Comment the "why", not the "what". PHPDoc for public methods