Home
Docs
Guides
Upgrading alphas

View as Markdown Open in v0 Open in ChatGPT Open in Claude Open in Scira

# Upgrading alphas

Electrik 5.x is **alpha**. Expect breaking changes between tags.

## Checklist

1. Read the package [CHANGELOG](https://github.com/electrikhq/electrik/blob/5.x/CHANGELOG.md)
2. `composer update electrik/electrik electrik/slate`
3. Re-run migrations if new ones shipped
4. `php artisan electrik:permissions:sync` if the catalog changed
5. `php artisan electrik:stripe:sync` if billing models changed
6. Diff `config/electrik.php` against the published stub (`electrik:install --force` only if you understand the overwrite)

Pin a specific alpha in production experiments (`5.0.0-alpha.14`) rather than floating `@alpha` if you need reproducibility.

## 4.x → 5.x

5.x is a new stack (Laravel 12, Slate 3, Livewire 4, package-first). Treat migration as a **re-install** onto a fresh app rather than an in-place upgrade from Electrik 4, unless you have a dedicated migration plan.

Upgrading alphas

Electrik 5.x is alpha. Expect breaking changes between tags.

Checklist

Read the package CHANGELOG
composer update electrik/electrik electrik/slate
Re-run migrations if new ones shipped
php artisan electrik:permissions:sync if the catalog changed
php artisan electrik:stripe:sync if billing models changed
Diff config/electrik.php against the published stub (electrik:install --force only if you understand the overwrite)

Pin a specific alpha in production experiments (5.0.0-alpha.14) rather than floating @alpha if you need reproducibility.

5.x is a new stack (Laravel 12, Slate 3, Livewire 4, package-first). Treat migration as a re-install onto a fresh app rather than an in-place upgrade from Electrik 4, unless you have a dedicated migration plan.