Laravel Stubs Laravel Package

Product Decisions This Supports

• Laravel 13+ Migration: Proactively adopt this package to ensure compatibility with Laravel 13.x, avoiding future refactoring costs for teams upgrading or starting new projects.
• PHP 8.5 Readiness: Future-proof the codebase by leveraging PHP 8.5 features (e.g., new attributes, typed class constants) in generated stubs, reducing manual updates during upgrades.
• Strategic Tech Stack Alignment: Reinforce the decision to standardize on modern Laravel/PHP versions by embedding this package into CI/CD pipelines (e.g., post-update-cmd in composer.json) to auto-update stubs during dependency upgrades.
• Package Ecosystem Scaling: For teams building reusable Laravel packages, this release solidifies integration with orchestra/canvas for Laravel 13.x, ensuring consistency across distributed codebases.
• Developer Productivity: Accelerate feature development by eliminating manual stub customization for new Laravel/PHP versions, freeing engineers to focus on business logic.

When to Consider This Package

• Adopt if:

  • Your team is upgrading to Laravel 13.x or PHP 8.5 and wants to avoid manual stub adjustments.
  • You prioritize long-term maintainability and want to align with the latest Laravel/PHP features in generated code (e.g., new attributes, typed properties).
  • Your project uses orchestra/canvas and needs standardized stubs for Laravel 13.x packages.
  • You’re starting a new Laravel project and want to skip legacy patterns (e.g., down() methods, base controllers) from day one.
  • Your team values automated DX improvements (e.g., auto-updating stubs via Composer) to reduce cognitive load during upgrades.

• Look elsewhere if:

  • Your project is locked into Laravel <12 or PHP <8.2 and lacks the bandwidth to upgrade.
  • You require legacy Laravel features (e.g., down() methods, guarded attributes) that this package intentionally omits.
  • Your team prefers highly customized stubs that diverge from the package’s minimalist approach (e.g., verbose docblocks, opinionated base classes).
  • You’re not using orchestra/canvas and don’t need Laravel 13.x package stubs.
  • Your priority is community adoption over niche opinions (this package remains low-profile but gains relevance with Laravel 13.x support).

How to Pitch It (Stakeholders)

For Executives:

*"This update makes the package a must-have for Laravel 13.x and PHP 8.5 projects, ensuring our code generation stays modern and consistent without manual effort. By adopting it now, we:

• Future-proof our stack with zero refactoring during upgrades.
• Cut onboarding time by 20%+ with standardized, opinionated stubs.
• Reduce tech debt by eliminating legacy patterns (e.g., down() methods) upfront. Cost: Minimal (one Composer install). Risk: None—easy to revert or customize further. This is a low-effort, high-impact DX investment."*

For Engineering:

*"v2.1.0 is a game-changer for Laravel 13.x teams:

• Auto-updates stubs for PHP 8.5/Laravel 13.x features (e.g., new attributes, typed class constants).
• Drops legacy cruft: No down() methods, no base controllers, no guarded attributes—just clean, modern templates.
• Works with orchestra/canvas: Perfect for package developers targeting Laravel 13.x. How to adopt:

1. Update: composer require rawilk/laravel-stubs --dev
2. Publish: php artisan custom-stub:publish
3. (Optional) Add to composer.json to auto-update stubs on Laravel upgrades. Tradeoff: Loses some Laravel defaults, but gains speed, consistency, and future-readiness."*

For Developers:

*"Tired of stubs breaking after Laravel upgrades? This package now automatically handles Laravel 13.x/PHP 8.5—no more manual fixes! What’s new:

• PHP 8.5 features: Typed class constants, new attributes—all in your stubs.
• Laravel 13.x ready: Migrations/controllers/models use the latest syntax.
• Still minimalist: No down() methods, no base classes, no fluff. Quick start:

composer require rawilk/laravel-stubs --dev
php artisan custom-stub:publish

Pro move: Add this to your composer.json to auto-update stubs when Laravel upgrades:

"scripts": {
  "post-update-cmd": "php artisan custom-stub:publish"
}

Result: Faster dev cycles, less boilerplate, and zero stub-related surprises."*