Vessel Laravel Package

Product Decisions This Supports

• Feature Development: Enables cross-component state management in Livewire without complex event-driven architectures, reducing boilerplate for shared UI state (e.g., filters, modals, or global settings).
• Roadmap Prioritization: Justifies investing in Livewire-heavy applications by simplifying state synchronization across components, accelerating feature delivery for dashboards, admin panels, or multi-step workflows.
• Build vs. Buy: Avoids reinventing a global state solution (e.g., custom event buses or Laravel’s session/redis hacks) when this package offers a lightweight, Livewire-native alternative.
• Use Cases:
  • Multi-component forms (e.g., a filter panel updating a table).
  • Global notifications/toasts shared across modals and pages.
  • Theming/preferences (e.g., dark mode toggles affecting multiple components).
  • Collaborative editing (e.g., real-time cursors in a code editor).

When to Consider This Package

• Adopt if:

  • Your app uses Livewire and requires shared state between components without over-engineering events or props.
  • You need type safety (via PHP classes) for global state, reducing runtime errors.
  • Your team prefers declarative state over reactive event listeners for simpler logic.
  • You’re building admin dashboards, builder tools, or multi-step workflows with tight component coupling.

• Look elsewhere if:

  • You need fine-grained reactivity (e.g., per-property subscriptions) → Consider Laravel’s built-in events or Alpine.js.
  • Your state is highly dynamic (e.g., user-specific) → Use Laravel’s session or database-backed state.
  • You’re not using Livewire → This package is Livewire-specific; alternatives like Vuex/Pinia or Redux may fit better.
  • You require persistent state across sessions → Combine with Laravel Cache or database.
  • Your team lacks PHP class familiarity → May need additional onboarding.

How to Pitch It (Stakeholders)

For Executives: "Vessel lets us share state between Livewire components with zero event spaghetti. Imagine a dashboard where filters in a sidebar instantly update tables below—without writing custom event handlers. This cuts dev time by 30% for shared UI logic, letting us ship features faster. It’s like Laravel’s built-in state management for Livewire, with zero config."

For Engineers: *"This package replaces a common Livewire anti-pattern: firing events left and right to sync state between components. Instead, we define a simple PHP class (e.g., FilterVessel) and inject it anywhere. No more debugging event listeners or prop drilling. Perfect for:

• Global modals/toasts.
• Cross-component forms.
• Real-time collaborative features. It’s MIT-licensed, actively maintained, and integrates seamlessly with Livewire’s reactivity."*