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 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.
Unpublished candidate
Lumen 3 → Lumen 4
Review spacing, focus behavior, dates, charts, and native signatures. V4 is still a local release candidate.
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