HealkiteDocs

Releasing updates

healkite release bundles, compiles, diffs, signs, uploads and publishes in one step.

sh
npx healkite release -p android -c <channel-key> -r 1.0.0 --sign healkite-signing.pem

Runtime versions

A release targets one runtime version: the native build it's compatible with. By default that's the app version (versionName / CFBundleShortVersionString). Ship a new store build when native code changes, and release JavaScript updates against its version.

Common options

-p, --platformios or android
-c, --channelChannel key
-r, --runtime-versionTarget runtime version
--rollout <pct>Share of devices, 1–100
--mandatoryApply on download instead of next launch
-d, --descriptionRelease notes shown in the dashboard
--sign <pem>Sign with your key (or HEALKITE_SIGNING_KEY / HEALKITE_SIGNING_KEY_PATH)
--guardedGuarded rollout
--at, --until, --deviceSchedules & targeting
--hotfix, --pushInstant hotfix
--experiment, --metricA/B experiments
--max-size, --max-growthSize budget (see below)
--patch-from <n>Diff against the last N bundles (default 3, 0 disables)
--no-hermesFor JSC apps
--project, --entry-fileMonorepos and custom entries

Patches

Healkite makes binary diffs from your last three distinct bundles on the same target. A device on one of those gets the patch (usually a few KB); anyone else gets the full bundle. Patches are verified like bundles.

Bundle size guard

sh
npx healkite size -p android -c <channel-key> -r 1.0.0 --max-growth 10

Prints the size and the change vs the latest release, and exits non-zero over budget. release takes the same --max-size 2MB / --max-growth 10 flags and stops before uploading.

Promote between channels

Test on staging, then publish the exact same bundle to production: the Promote button on a release in the dashboard, the promote_release MCP tool, or:

sh
npx healkite codepush promote "My App" staging production -p android -r 25

Managing releases

sh
npx healkite releases -c <channel-key> -p android
npx healkite patch rel_… --rollout 50
npx healkite patch rel_… --disable