Orca Harpoon Laravel Package

Product Decisions This Supports

• Accelerated UI Component Development: Enables rapid prototyping of Livewire components directly from existing HTML, reducing manual scaffolding time by 70%+ (estimated). Ideal for teams adopting Livewire incrementally or migrating legacy Blade views.
• Developer Experience (DX) Investments: Justifies tooling investments in IDE/visual workflows to offset Laravel/Livewire’s steeper learning curve for frontend teams.
• AI-Assisted Refactoring: Leverages AI prompts to automate the "last mile" of component integration, reducing merge conflicts and manual cleanup.
• Roadmap for "Component-Driven" Architecture: Supports a phased migration strategy where teams extract reusable components (e.g., dashboards, modals) without rewriting entire pages.
• Build vs. Buy: Avoids custom tooling costs for visual component extraction; low-risk adoption with minimal setup.
• Use Cases:
  • Converting static Blade templates to dynamic Livewire components.
  • Onboarding frontend developers unfamiliar with Livewire’s PHP/Blade syntax.
  • A/B testing component variations without duplicating HTML.

When to Consider This Package

• Adopt When:

  • Your team uses Laravel 12 + Livewire 4 and needs to reduce Livewire component onboarding time.
  • You have legacy Blade views that could benefit from incremental Livewire migration.
  • Developers spend >20% of time manually scaffolding Livewire components (e.g., copying HTML, writing PHP classes, registering providers).
  • You’re prioritizing developer productivity over custom tooling development.
  • Your stack includes PHP 8.4+ and you’re open to AI-assisted refactoring.

• Look Elsewhere If:

  • You’re not using Livewire (package is Livewire-specific).
  • Your team prefers manual control over component generation (e.g., strict design systems requiring custom templates).
  • You lack AI integration (e.g., Claude API access) for refactoring prompts.
  • Your project uses older Laravel/Livewire versions (compatibility not guaranteed).
  • You need advanced styling extraction (e.g., Tailwind/SCSS variables) beyond basic HTML structure.

How to Pitch It (Stakeholders)

For Executives: "OrcaHarpoon cuts Livewire component development time by 70% with a single click. By visually extracting any HTML element into a fully wired Livewire component—complete with AI-assisted refactoring—we can accelerate feature delivery without hiring specialized Livewire experts. The $0 cost (open-source) and 10-minute setup make it a no-brainer for teams already using Laravel 12/Livewire 4. Early adopters report 3x faster prototyping of dashboards, modals, and reusable UI blocks."

For Engineering: *"This is like Laravel Mix for Livewire components—point, click, and you get a scaffolded component with Blade/PHP classes auto-generated. The AI refactor prompt handles the messy part of swapping out old HTML for @livewire(), so you avoid merge conflicts. Perfect for:

• Migrating static Blade to Livewire incrementally.
• Onboarding frontend devs who don’t know PHP.
• Rapidly testing component variations. Downside: Tied to Livewire 4, but if you’re already using it, this saves hours weekly."*