This chapter aggregates the most relevant upgrade paths and migrations for the Folio Rails Engine. Content is derived from the original wiki articles and verified against the current codebase.
- Commit and push all pending changes.
- Run the test suite and ensure it is green.
- Create a fresh backup of the database and uploaded files.
- Read the release notes for every Folio version you are jumping over.
For many upgrades the safest path is to re-run the relevant Folio generator in a throw-away branch, compare the generated files with your project, and cherry-pick differences.
Always read the changelog and test thoroughly before deploying upgrades to production.