About

Official Laravel boilerplate is minimalistic by design, empowering developers with flexibility while leaving many foundational decisions up to them.

This boilerplate fills that gap, providing pre-configured, best-practice-driven strong foundation. That means you start fast and build right from day one.

Features

✨ Up-to-Date with the Latest Versions

• ✔️ php 8.4
• ✔️ Laravel 12
• ✔️ Official Laravel boilerplate

✨ Optimized for Local Development

• ✔️ Essential packages configured for a seamless local development experience
• ✔️ Configured docker-compose.yml
• ✔️ Xdebug configured in dev and ci image
• ✔️ Useful and handy composer commands for streamlined development

✨ Built-in CI/CD

• ✔️ GitHub CI workflow with necessary automated checks:
  • composer lint — ensures consistent code styling
  • composer rector — keeps your code up to date
  • composer test.arch — architecture testing
  • composer test.unit — unit tests
  • composer test.feature — feature tests with a minimum coverage check
• ✔️ Deploy wherever you want
  • Production-ready Dockerfile (using serversideup/docker-php) for containerized deployment
  • By default, the deploy job pushes image to AWS ECR repository. If you initiate an AWS compute service that supports container image (e.g. AppRunner, Lambda or EKS), deployment should work out-of-the-box just by configuring below variables in GitHub.
    • AWS_ACCESS_KEY_ID (secret)
    • AWS_ECR_REGISTRY (secret)
    • AWS_SECRET_ACCESS_KEY (secret)
    • AWS_ECR_REPOSITORY (variable)
    • AWS_REGION (variable)
  • Modify .github/workflows/200-cd.yml if you don't want AWS containerized deployment.

✨ Elegant testing

• ✔️ PestPHP configured with Architecture, Unit & Feature test-suites

✨ Essential Packages out of the box

• ✔️ IDE-Helper for autocompletion
• ✔️ Rector for effortless upgrades
• ✔️ Pint for code-styling
• ✔️ Larastan for static analysis, configured to max level

✨ Packed with Best Practices

• ✔️ Check for consistent code-styling
• ✔️ Static analysis with max level
• ✔️ Code-quality checks using rector
• ✔️ Strict models
• ✔️ Mandatory declaring strict types
• ✔️ Architecture tests — Laravel presets
• 🟡 A few more that we can't mention here, with many more on the roadmap

✨ Customizable

You can easily modify this boilerplate to fit your specific requirements.

Quick-start

• Installation
• Development
• Testing
• Deployment

Inspiration

        

Contributing

• Issues 👉 for bugs
• PRs 👉 for contributions (Fork the project and create MR targeting main branch)
• Discussions 👉 for help, thoughts and suggestions