Rollbacks

Rollbacks are a way to revert to a previous bundle of your app. This is useful when you have deployed a new bundle of your app and it is not working as expected.

Automatic rollbacks

It is strongly recommended to enable automatic rollbacks for your app by setting the readyTimeout configuration option of the Capacitor Live Update plugin to a value greater than 0:

capacitor.config.json

{
  "plugins": {
    "LiveUpdate": {
      "readyTimeout": 10000
    }
  }
}

This will automatically roll back to the built-in bundle if the app does not call the ready() method of the Capacitor Live Update plugin within the specified time.

Manual rollbacks

Delete a bundle

To rollback to a previous bundle of your app, you can just delete the latest bundle. This makes the previous bundle the latest bundle and the app will automatically roll back to it the next time the app calls the sync() method of the Capacitor Live Update plugin.

Disable a bundle

If you want to keep the latest bundle but disable it, you can roll out the bundle to 0% of users using the --rollout option when updating the bundle using the Capawesome CLI:

npx capawesome apps:bundles:update --rollout 0

This will disable the latest bundle and the app will automatically roll back to the previous bundle the next time the app calls the sync() method of the Capacitor Live Update plugin.