Installer Laravel Package

Product Decisions This Supports

• Accelerate Developer Onboarding: Reduces time-to-first-deploy for new Laravel projects by automating boilerplate setup (e.g., .env, migrations, dependencies). Justifies investment in developer experience (DX) tools. New: Interactive starter kit installer hooks enable customizable project templates without sacrificing speed, bridging the gap between standardization and flexibility.
• Standardize Project Templates: Enables consistent project scaffolding across teams, reducing configuration drift. Aligns with roadmap items for platform-wide Laravel adoption. New: Symfony 8 compatibility broadens use cases for teams using mixed PHP ecosystems.
• Build vs. Buy: Avoids reinventing a CLI tool for project initialization, leveraging Laravel’s official, battle-tested solution. Lowers maintenance burden compared to custom scripts. New: Interactive starter kit hooks allow teams to extend the installer with custom logic (e.g., pre-install scripts, environment-specific configurations) while retaining the core tool’s reliability.
• Use Cases:
  • Internal Tools: Rapid prototyping of internal dashboards or APIs.
  • Open-Source Contributions: Quickly spin up Laravel projects for community plugins.
  • Education: Standardized environments for teaching Laravel (e.g., bootcamps, docs).
  • CI/CD Pipelines: Pre-configured project templates for automated deployments. New: Interactive hooks enable custom CI/CD integrations (e.g., post-installation setup steps).
  • Mixed PHP Ecosystems: Teams using Symfony 8 alongside Laravel can now leverage the installer for unified dependency management.
  • Custom Starter Kits: Teams requiring non-standard project structures (e.g., monorepos, legacy integrations) can now define interactive hooks to extend the installer’s functionality.

When to Consider This Package

• Adopt When:
  • Your team uses Laravel and needs a reliable, zero-config way to scaffold projects.
  • You prioritize developer velocity over customization (e.g., no need for bespoke project structures).
  • Your stack includes modern frontend tools (e.g., Vite, Inertia, Livewire) that the installer supports out-of-the-box.
  • You want to reduce onboarding friction for new hires or contributors.
  • New: You need customizable project templates but still want to avoid maintaining custom scripts. The interactive starter kit hooks allow for extensibility without sacrificing the installer’s core benefits.
  • New: You use AI-driven workflows (e.g., GitHub Copilot, DevOps automation) and need structured output for programmatic project setup.
  • New: Your team uses Symfony 8 and wants to standardize Laravel project initialization alongside Symfony projects.
• Look Elsewhere If:
  • You require highly complex customization (e.g., multi-stage installation logic, conditional dependency injection). Consider custom Composer scripts or platforms like Forge/Envoyer.
  • Your team uses non-Laravel/PHP frameworks (e.g., Node.js, Ruby on Rails). Use framework-specific installers.
  • You need enterprise-grade templating (e.g., dynamic .env variables, multi-environment setups) with no room for customization. The installer’s hooks add flexibility but may introduce complexity.
  • Your CI/CD pipeline already handles highly specialized project initialization (e.g., Docker-based setups with custom entrypoints) and lacks compatibility with the installer’s hooks. The new features may not justify adoption in this case.

How to Pitch It (Stakeholders)

For Executives: "The Laravel Installer (v5.28.0) is now a turnkey solution for Laravel and Symfony 8 projects, cutting setup time from 30+ minutes to under 2 minutes while enabling AI-driven automation and customizable project templates. By standardizing our project templates with interactive starter kit hooks, we reduce technical debt from configuration drift while allowing teams to extend the installer for niche use cases—all without maintaining custom scripts. This is a low-risk, high-reward investment in developer productivity, with no ongoing maintenance costs. Competitors like Symfony’s Flex require manual intervention, adding friction to our velocity. The new hooks also future-proof our stack for custom CI/CD integrations and legacy system compatibility."

For Engineering: *"This replaces ad-hoc composer create-project commands with a smart, interactive CLI that now supports:

• Symfony 8 compatibility for mixed PHP ecosystems.
• Structured JSON output for AI/automation agents (e.g., GitHub Actions, DevOps scripts).
• Interactive starter kit hooks to extend the installer with custom logic (e.g., pre-install scripts, environment-specific configs).
• Environment setup (.env, APP_URL, database config) with fixes for edge cases (e.g., Pest.php).
• Frontend scaffolding (Vite, Inertia, Livewire) and modern tooling (Bun, pnpm). It’s actively maintained (updated monthly), integrates with our Laravel/Symfony stack, and supports programmatic initialization in CI. The trade-off is minimal customization by default—ideal for consistency and scalability. New: Teams can now hook into the installer’s workflow to add custom steps without forking the tool."*

For Developers: *"No more manual composer create-project + .env tweaks. The installer now:

• Auto-detects your dev environment (Herd/Valet/Docker) and Symfony 8 projects.
• Generates structured JSON for AI tools to parse (e.g., laravel new project --json).
• Fixes Pest.php quirks and other edge cases automatically.
• Skips prompts in CI with --no-interaction or --json.
• Supports custom starter kits via interactive hooks—so we can add pre-install scripts, environment checks, or legacy integrations without breaking the core tool.
• Works seamlessly with modern tooling (Vite, Livewire, Bun). It’s faster, safer, and more reliable than rolling our own scripts—and now lets us extend it for our specific needs."*