HealkiteDocs

Rollback & kill switch

Automatic rollback on the device

Every new bundle's first launch is a trial. If the app crashes or freezes before notifyAppReady() (called by sync()), the next launch goes back to the previous bundle and the bad one is never retried. This works even when your servers are down.

Roll back a release

sh
npx healkite rollback -p android -c <channel-key> -r 1.0.0              # previous release
npx healkite rollback -p android -c <channel-key> -r 1.0.0 --to v4      # a specific one
npx healkite rollback -p android -c <channel-key> -r 1.0.0 --to embedded

Or Settings → Roll back in the dashboard. Devices switch on their next launch, or right away with instant hotfix.

Kill switch

Show a maintenance screen without shipping anything, for example while your backend is down:

sh
npx healkite kill-switch on -p ios -c <channel-key> -r 1.0.0 \
  --title "We'll be right back" --message "Payments are paused for maintenance." --url https://status.example.com
npx healkite kill-switch off -p ios -c <channel-key> -r 1.0.0

Wrap your app in <KillSwitchGate> (or read useKillSwitch()) to render it. Manifests are signed, so nobody else can turn it on.