Upgrade Guide

Before You Start

Before upgrading, take these precautions:

Back up your database. E-commerce data (orders, customers, prices) is difficult to recover if a migration fails.

Run the upgrade on a staging environment first. Verify everything works before touching production.

If upgrading across multiple versions (e.g., v2.2 to v2.5), follow each guide in sequence. Do not skip versions.

Upgrade Guides

From	To	Summary
v2.9	v2.10	Security release: admin authorization audit, slide-over IDOR fix, exact tax on discounted totals (`TaxableItem` contract change), atomic stock reservation (`StockReserver` contract, `Stockable::tracksInventory()`), guest per-user discount block. No database migrations
v2.8	v2.9	Laravel 13 support, onboarding wizard rebuilt on Filament Schema, cache stores scalars instead of models, Stripe SDK upgraded to v19. No database migrations
v2.7	v2.8	Security release: authorization guards across admin Livewire components, atomic discount reservation, `orders` discount snapshot columns
v2.6	v2.7	Money values stored in smallest currency unit (cents), slide-over components replaced, 2FA split into SOLID interfaces
v2.5	v2.6	Cart package, tax system, auth models moved to admin package, event renaming, render hooks
v2.4	v2.5	Order system split into three independent statuses (order, payment, shipping), payment drivers, shipment tracking
v2.2	v2.3	Product Tags feature with new permissions and feature flag
v2.1	v2.2	Repository pattern removed, Model Contracts system, Filament v4, ShopperUser trait, sidebar redesign

There is no upgrade guide for v2.3 to v2.4. That release only added Spanish translations and internal render hooks with no breaking changes.

Before You Start