magewire-backwards-compatibility
CommunityPreserve v1 behavior while migrating Magewire.
System Documentation
What problem does it solve?
Reference for Magewire's framework-level backwards compatibility system. Use when migrating Magewire v1 (Livewire v2) code to v3, enabling BC on components, understanding wire:model / entangle / hook behavioral changes between v2 and v3, or working with the BC memo flag, deprecated v1 component APIs, and the #[HandleBackwardsCompatibility] attribute. Theme-agnostic — BC applies to any Magewire component in any Magento theme. For theme-specific BC JS implementations (e.g. Hyvä Checkout), see the matching theme's BC skill.
Core Features & Use Cases
- Core BC layer: lib/MagewireBc/ handles compatibility via Traits and PHP attributes to expose legacy APIs and property aliases.
- Theme-specific BC layers: per-theme BC rules controlled by memo.bc.enabled and optional JS rewrites.
- Migration guidance: supports opt-in via #[HandleBackwardsCompatibility] or data-store flags to progressively migrate components.
- Use Case: migrate a large Magento store with many Magewire components without rewriting every component at once.
Quick Start
Annotate your Magewire component with #[HandleBackwardsCompatibility] to enable BC and begin migrating to v3 without breaking existing v1 behavior.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: magewire-backwards-compatibility Download link: https://github.com/magewirephp/magewire/archive/main.zip#magewire-backwards-compatibility Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.