Migrate your app model to the latest version

To continuously enhance functionality and improve user experience, new versions of UI Bakery may include app model migrations. These migrations modify the app model stored in your Git repositories. Therefore, a manual app model migration is necessary to ensure a smooth development process and prevent developers from encountering merge conflicts.

App model migration is not strictly required but is highly recommended. If the migration is not performed immediately following an update using this guide, it will be done separately in each branch automatically.

Consequently, all developers will see similar changes in their pull requests until the migration changes are merged into the main branch and subsequently into their individual branches.

Follow these steps for a successful migration:

1. Create a migration branch

   • Start by creating a new branch named migrate-release/0.0.0 from the main branch.

   • The newly created branch will be automatically migrated by UI Bakery.

2. Merge migrated changes in the main branch

   • Commit the changes to the migration branch.

   • Create a pull request from the migrate-release/0.0.0 branch to the main branch.

   • Merge the pull request into the main branch.

3. Merge migrated model into branches under active development

   • Switch back to the main branch in UI Bakery and pull the latest changes.

   • Using Git, merge the updated main branch into any branches under active development.

   • Go to these development branches and pull the changes.

By following this process, you will ensure that your app model is consistently up-to-date, minimizing the risk of conflicts and maintaining a smooth development workflow.