Cube Common Develop Laravel Package

Product Decisions This Supports

• Internal Developer Productivity (IDP) Initiatives: Accelerate PHP/Laravel development by standardizing testing, code quality checks, and DevOps workflows (e.g., pre-commit hooks, template validation).
• Roadmap for "Build vs. Buy": Justify adopting this package over custom solutions for repetitive tasks like:
  • Test automation (e.g., route validation, page-load tests).
  • Code linting/standards (e.g., Twig template checks, PHP array syntax).
  • CI/CD integration (e.g., commit hooks, XLIFF file validation).
• Use Cases:
  • Monorepos or multi-package projects needing shared test utilities (e.g., SmoketestPageLoadingBase).
  • Teams migrating to Symfony 4.3+ or PHPUnit 7, requiring backward-compatible test bases.
  • Localization workflows (XLIFF file management via check-commit-cube.sh).
  • Onboarding new devs with standardized checks (e.g., email validation, controller action rules).

When to Consider This Package

Adopt if:

• Your team uses Laravel/Symfony and needs shared test utilities (e.g., web tests, route validation) without reinventing wheels.
• You’re maintaining legacy PHP codebases and want to enforce modern standards (e.g., auto-wiring, short array syntax []).
• Your workflow includes localization (XLIFF files) or pre-commit checks (e.g., tag validation, template syntax).
• You’re migrating to Symfony 4.3+ and need compatibility layers (e.g., WebTestBase updates).

Look elsewhere if:

• Your stack is non-PHP (e.g., Node.js, Python).
• You need production-ready features (last release: 2020; low stars/dependents signal risk).
• Your team prefers modern tooling (e.g., PestPHP, Laravel Pint) over Symfony-centric solutions.
• You require active maintenance (MIT license but no recent updates).

How to Pitch It (Stakeholders)

For Executives: *"This package standardizes our Laravel/Symfony development workflows, reducing busywork for engineers by automating:

• Testing: Pre-built test cases for routes, page loads, and template validation (saves 10–20 hrs/month per dev).
• Code Quality: Enforces consistent syntax (e.g., [] arrays) and catches errors early via pre-commit hooks.
• Localization: Simplifies XLIFF file management for global products. Cost: Free (MIT license); Risk: Low (internal-only use case). Replaces custom scripts, accelerating onboarding and reducing tech debt."*

For Engineering: *"Leverage this to:

1. Unify tests: Use SmoketestPageLoadingBase for cross-project page-load tests (Symfony 4.3+ compatible).
2. Enforce standards: Add check-commit-cube.sh to CI/CD to block bad commits (e.g., broken Twig, missing emails).
3. Save time: Pre-written checks for routes, controllers, and XLIFF files—no reinventing. Tradeoff: Legacy codebase (last updated 2020), but MIT license lets us fork if needed. Start with dev dependencies (composer require --dev)."*