Boost Spatie Guidelines Laravel Package

Product Decisions This Supports

• Standardization & Consistency: Adopt a unified coding style across teams, reducing onboarding time and cognitive load for developers. Aligns with Spatie’s battle-tested Laravel/PHP conventions, ensuring high-quality, maintainable code.
• AI-Assisted Development: Accelerate development workflows by leveraging AI (e.g., Laravel Boost) to generate code that adheres to Spatie’s guidelines, reducing manual review cycles and improving developer productivity.
• Build vs. Buy: Avoid reinventing custom style guides or enforcing ad-hoc rules. This package provides a pre-built, maintainable solution with minimal overhead.
• Scaling Teams: Ideal for growing teams or agencies where consistency is critical. Reduces friction in code reviews and merges by enforcing a shared standard.
• Onboarding & Training: Simplifies ramp-up for new hires by providing clear, documented conventions. Reduces "why is this coded this way?" debates.
• Quality Gates: Integrate with CI/CD pipelines (e.g., PHPStan, Psalm) to enforce guidelines automatically, catching deviations early.
• Laravel Ecosystem Alignment: Ensures compatibility with Spatie’s other packages (e.g., Laravel-Permission, Media Library) and broader Laravel community practices.

When to Consider This Package

• Avoid if:

  • Your team already has a mature, customized style guide deeply integrated into your workflow (e.g., custom ESLint/PHP-CS-Fixer rules).
  • You’re using a non-Laravel PHP framework (e.g., Symfony, WordPress) where Spatie’s conventions may not align.
  • Your project requires framework-agnostic guidelines (e.g., for shared libraries used across multiple stacks).
  • You lack AI-assisted tooling (e.g., Laravel Boost) and prefer manual enforcement (e.g., via PHP-CS-Fixer alone).
  • Your team resists strict conventions and prioritizes flexibility over standardization.

• Look elsewhere if:

  • You need custom domain-specific rules (e.g., financial compliance, legacy system constraints).
  • Your stack includes non-PHP components (e.g., JavaScript/TypeScript) requiring unified guidelines.
  • You’re in a highly experimental phase where conventions are still evolving.

How to Pitch It (Stakeholders)

For Executives/Product Leaders:

"This package lets us standardize our Laravel codebase using Spatie’s proven guidelines—just like top-tier agencies and enterprises do. By integrating with AI tools like Laravel Boost, we’ll cut development time by 20-30% while ensuring high-quality, maintainable code. It’s a low-lift way to future-proof our tech stack, reduce bugs, and make onboarding new hires smoother. Think of it as ‘autopilot for coding standards’—no more debates over formatting or naming, just consistent, scalable code."

For Engineering Teams:

*"Spatie’s guidelines are industry-standard for Laravel, and this package makes it trivial to enforce them—especially with AI assistance. Here’s why it’s a no-brainer:

• AI-generated code now follows our team’s conventions out of the box (no more fixing up AI outputs).
• Zero maintenance: Spatie updates the rules; we just install.
• CI/CD ready: Works with PHPStan/Psalm to auto-fix or block violations.
• Future-proof: Aligns with Spatie’s ecosystem (e.g., permissions, media libraries). Let’s demo it in a sprint—it’ll save us hours in reviews and tech debt."*

For Developers:

"Tired of arguing about camelCase vs. snake_case or where to put type hints? This package locks in Spatie’s Laravel best practices—PSR compliance, happy-path logic, clean Blade templates, and more—so your IDE/AI writes code that just works. Install it in 5 minutes, and your new PRs will look like they were written by a senior dev. Plus, it plays nice with Laravel Boost for instant, high-quality code suggestions."