React Native OTA updates: how they work and how to ship them safely
UPDATED NOVEMBER 16, 2026
An over-the-air (OTA) update replaces the JavaScript bundle and assets of a React Native app on users' phones without a new App Store or Google Play release. Native code, permissions and the app binary itself still need a store build.
How OTA updates work
- Build: your JavaScript is bundled (with Hermes, compiled to bytecode) together with images and other assets.
- Publish: the bundle is uploaded to an update service and assigned to a channel (for example
production) and a runtime version that matches the native app it was built for. - Check: when the app starts, the SDK asks the service whether a newer bundle exists for its channel and runtime version.
- Download and apply: the SDK downloads the bundle (or a small diff), verifies it, and runs it on the next launch, or immediately for urgent fixes.
What you can and can't update over the air
| Change | Over the air | Needs a store release |
|---|---|---|
| JavaScript and TypeScript code | Yes | |
| Images, fonts, JSON and other bundled assets | Yes | |
| New screens and UI built from existing native components | Yes | |
| New or upgraded native modules | Yes | |
| React Native version upgrades | Yes | |
| Permissions, entitlements, app icon, Info.plist or AndroidManifest | Yes |
Are OTA updates allowed by Apple and Google?
Yes, within limits. Apple's developer agreement allows apps to download interpreted code such as JavaScript as long as it doesn't change the app's primary purpose, create a storefront for other code, or bypass the platform's security. Google Play allows code that runs in an interpreter or virtual machine, such as JavaScript, but not downloading native code like .so or .dex files outside Play. Use OTA updates for fixes and improvements, and ship new native features through the stores.
The risks, and how to ship safely
An OTA update reaches users in minutes, and so does a bad one. These practices keep a mistake from becoming an outage:
- Roll out in stages (1% → 10% → 50% → 100%) and watch crash-free sessions at each step.
- Halt automatically when crashes or key business events (sign-ups, checkouts) get worse than the previous release.
- Roll back on the device: treat each new bundle's first launch as a trial and fall back if it never reaches the first screen.
- Match runtime versions so a bundle never runs on a binary with different native code.
- Sign bundles and manifests so only your releases can run.
- Keep a kill switch to turn a feature off for everyone without a new release.
How Healkite does it
- Guarded rollouts: a release widens 1% → 10% → 50% → 100% on its own and stops automatically when crash-free sessions or your own events (for example
checkout_successper session) get worse than the previous release. - Rollback on the device: a new bundle's first launch is a trial; if the app crashes or freezes before it's ready, the next launch goes back to the previous bundle, even when your servers are down.
- Backup CDN: if the primary CDN can't be reached, the SDK downloads updates from a backup.
- Signed end to end: bundles are signed with your ECDSA P-256 key and manifests are signed by the server, so a compromised CDN can't push code or replay an old release.
- Diff patches: binary diffs of Hermes bytecode, typically 80–99% smaller than full bundles.
- CodePush compatible: the same JavaScript API and CLI verbs, plus an MCP server for AI coding tools and a self-hosted option.
A release is one command: npx healkite release -p ios -r 1.4.0 --guarded. Start with the quick start, or compare services in CodePush alternatives in 2026.
Frequently asked questions
What is an OTA update in React Native?
An over-the-air update replaces an app's JavaScript bundle and assets on users' phones without a new App Store or Google Play release. The app checks an update service, downloads the new bundle and runs it on the next launch.
Can I update native code over the air?
No. Native modules, React Native version upgrades, permissions and other changes to the binary need a store release. Only JavaScript and assets can be updated over the air.
Are React Native OTA updates allowed on the App Store?
Yes, as long as updates don't change the app's primary purpose, create a store for other code, or bypass security. Apple's developer agreement explicitly allows downloaded interpreted code such as JavaScript within those limits.
How big is an OTA update?
A full Hermes bundle is often a few megabytes. With binary diffs against recent releases, updates are typically 80–99% smaller; in one real app a 557 KB bundle update shipped as a 97 KB patch.
Do users need to restart the app to get an update?
By default the update runs on the next launch. You can mark a release mandatory to apply it immediately, or push an urgent fix so phones fetch it right away.