Migration guides
Upgrade Lumen with a clear path.
Start with your installed version. Review the changes, update dependencies together, and verify the application before shipping.
Lumen 5
Lumen 4 → Lumen 5
Install the CLI separately, await Astro enhancement, and adopt component CSS and editable recipes at your own pace.
Lumen 1 → Lumen 2
Migrate runtime imports, visual sizing, toast viewports, native dates, and exhaustive Swift switches.
Lumen 2 → Lumen 3
Update package versions and review exhaustive Swift icon switches. Existing component calls remain available.
Lumen 4
Lumen 3 → Lumen 4
Review spacing, focus behavior, dates, charts, and native signatures before upgrading to Lumen 4.
For an application skipping major versions, complete and verify each step in order. Each guide includes consumer checks and a rollback path.
Browse the release history