Releasing updates
healkite release bundles, compiles, diffs, signs, uploads and publishes in one step.
npx healkite release -p android -c <channel-key> -r 1.0.0 --sign healkite-signing.pemRuntime 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, --platform | ios or android |
-c, --channel | Channel key |
-r, --runtime-version | Target runtime version |
--rollout <pct> | Share of devices, 1–100 |
--mandatory | Apply on download instead of next launch |
-d, --description | Release notes shown in the dashboard |
--sign <pem> | Sign with your key (or HEALKITE_SIGNING_KEY / HEALKITE_SIGNING_KEY_PATH) |
--guarded | Guarded rollout |
--at, --until, --device | Schedules & targeting |
--hotfix, --push | Instant hotfix |
--experiment, --metric | A/B experiments |
--max-size, --max-growth | Size budget (see below) |
--patch-from <n> | Diff against the last N bundles (default 3, 0 disables) |
--no-hermes | For JSC apps |
--project, --entry-file | Monorepos 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
npx healkite size -p android -c <channel-key> -r 1.0.0 --max-growth 10Prints 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:
npx healkite codepush promote "My App" staging production -p android -r 25Managing releases
npx healkite releases -c <channel-key> -p android
npx healkite patch rel_… --rollout 50
npx healkite patch rel_… --disable