Upgrade Livewire 2.x to Livewire 3.x

The Livewire 3.x Shift automates the upgrade of your Laravel application from Livewire 2.x to Livewire 3.x. Using the Livewire 3.x Shift to automatically upgrade your Laravel application has an estimated time savings of 2 hours.

Livewire 3 offers an internal livewire:upgrade tool. If you manually bump your dependencies, you may use it to automates some of the upgrade process. The Livewire 3.x Shift automates all of the upgrade process in one-click.

Screenshot of a pull request with automated changes from the Livewire 3.x Shift

Requirements

A Laravel application running Livewire 2.x.

Core Upgrades

The Livewire 3.x Shift automates all of the changes performed by livewire:upgrade, including:

Re-namespacing Livewire components.
Updating wire:model, wire:submit, and wire:click modifiers.
Preserving entangle behavior.
Refactoring to new event dispatching.
Renaming test assertions.
Updating JavaScript events.

Additional Upgrades

In addition to the Core Upgrades, the Livewire 3.x Shift performs additional upgrades, including:

Merging new configuration options.
Naming parameters for event data.
Preserving URL query string behavior.
Refactoring component id property access.
Applying your code style.
Modernizing PHP syntax, such as short arrays and the null safe operator.
Bumping your dependencies for popular packages.

Manual Upgrades

There are some upgrades the Livewire 3.x Shift can not perform automatically. When Shift detects these it adds a detailed comment to the Pull Request to guide any additional steps you may need to do manually.

While Shift attempts to detect and automate the updates for popular packages, you may need to update some of your dependencies manually. Always review the changelog for your dependencies for any additional changes.