ScaleBun
LoginBook a DemoGet started
Skip to article

OTA Updates

Administrator

The OTA Updates area of the ScaleBun dashboard.

Updated Reviewed

What OTA updates are#

Overview
ScaleBun Overview dashboard
Overview

Over-the-air (OTA) updates ship a new JavaScript bundle to installed apps without going through an app store. The device checks for a newer bundle, downloads it, applies it atomically, and — if the new bundle misbehaves — reverts to the one it replaced. The native binary never changes; only the JS layer does, which is why a fix reaches users in minutes instead of a review cycle.

How a release reaches a device#

  1. Publish. You build a bundle and publish it to a channel. Bundles compile to Hermes bytecode by default.

  2. Check. Each device asks whether a newer bundle exists for its app version, platform and channel. The server answers: do nothing, download a named bundle, or roll back.

  3. Download & verify. The device fetches the bundle — a binary patch when one is available, a full download otherwise — verifies its SHA-256 and its ed25519 signature, and stages it next to the running one.

  4. Apply. The staged bundle is promoted in an atomic swap. Depending on the release's install mode the app restarts immediately, on next restart, or on next resume.

  5. Recover. If the new bundle crashes on boot, the device reverts to the previous one on the next cold start — on its own, with no network.

Add OTA to your app#

OTA lives in the @scalebun/react-native SDK. Enable it in your init() call — read the client key and API base from the dashboard's SDK setup panel rather than hard-coding them:

index.jsTypeScript
import { init } from '@scalebun/react-native';
init({  clientKey: 'skb_live_ck_…',  ota: {    enabled: true,          // turn OTA on    checkOnForeground: true, // check for a new bundle each time the app foregrounds    publicSigningKey: '<your ed25519 public key, hex>', // enforce authenticity  },});

New to native setup? Run npx scalebun doctor to verify your project first.

Two ways to drive it#

Everything after setup — publishing, staging a rollout, watching health, rolling back — you do either from the dashboard or from the CLI. They share one backend, so you can start a release in your terminal and finish it here.

DashboardShip, watch and recover updates from the console — Mission Control, rollouts, health, guards, fleet and more. Best for operating a release and reading what happened.CLIThe scalebun command line — an interactive menu and a guided wizard that take you from a fresh machine to a first release. Best for publishing, scripting and CI.

Related#

  • SDK install — get @scalebun/react-native into your app first.

  • SDK rollouts — percentage-based feature rollouts on the device.

OTA Updates · Dashboard · ScaleBun