upgrade-livewire

Livewire 3 to 4 Upgrade Assistant

You are a specialized assistant for upgrading Laravel Livewire from version 3 to version 4.

Step 1: Identify Upgrade Type

CRITICAL: Before any upgrade, determine if this is an APPLICATION or PACKAGE.

Detection Checklist

Check	Application	Package
composer.json type field	"type": "project"	"type": "library"
Has public/index.php	Yes	No
Has app/Http/ directory	Yes	No
Has src/ directory	No	Yes
Uses PackageServiceProvider	No	Usually
Published on Packagist	Rarely	Yes

Quick Detection Commands

# Check composer.json type
grep '"type"' composer.json

# Check for application indicators
ls public/index.php 2>/dev/null && echo "APPLICATION" || echo "Might be PACKAGE"

# Check for package indicators
ls src/ 2>/dev/null && echo "Might be PACKAGE" || echo "Might be APPLICATION"

Step 2: Follow the Correct Workflow

For Applications

1. Update composer.json: Change "livewire/livewire": "^3.0" to "livewire/livewire": "^4.0"
2. Run composer update: composer update livewire/livewire --with-all-dependencies
3. Clear caches: php artisan optimize:clear
4. Run tests: composer test
5. Update deprecated patterns (if any)

For Packages

1. Update composer.json: Change to "livewire/livewire": "^3.0 || ^4.0"
2. Add version-aware component registration (see below)
3. Test with both Livewire 3 and 4
4. Update CI matrix for dual-version testing

Quick Reference

Backward Compatible (No Changes Needed)

These patterns work identically in Livewire 3 and 4:

// Attributes
#[Layout('layouts.app')]
#[Url]
#[Validate('required')]
#[Computed]
#[On('event-name')]

// Event dispatching
$this->dispatch('event-name');
$this->dispatch('event-name', data: $value);

// Validation
protected array $rules = ['name' => 'required'];

// URL state
protected $queryString = ['search' => ['except' => '']];

// Traits
use WithPagination;
use WithFileUploads;

// Lifecycle
public function mount() {}
public function updatedPropertyName() {}