Overview

CodePushGo Live Updates deliver React Native JavaScript bundles and bundled assets to installed apps. Use them for compatible JavaScript changes, urgent fixes, rollout control, and rollback. Use normal app-store releases for native code changes.

Note

Live Updates do not replace native builds. If you add a native module, change permissions, change entitlements, or modify platform configuration, ship a new iOS or Android binary.

How live updates work

CodePushGo has three main pieces:

1. The React Native updater client installed in your app.
2. The CLI that detects the native bundle ID, builds/releases JavaScript bundles, and uploads them.
3. The console and Cloudflare Worker backend that store releases, channels, rollout metadata, stats, and rollback targets.

When you upload a release to a channel, compatible apps using that channel can discover the update from the Worker backend. The app identity is the native bundle ID by default, so the console, CLI, backend, and updater all refer to the same app.

Getting started

1. Complete the React Native quickstart to create an account, connect the app, and install the updater.

2. Upload a release:

   npx @codepushgo/cli@latest release --platform ios --version 1.0.1 --channel production

3. Open the console at https://console.codepushgo.com/app/home to inspect apps and releases.

4. Promote, pause, or roll back through channels when needed.

Next steps

Channels

Use channels to control production, beta, and development release tracks.

Rollbacks

Move a channel back to a previous JavaScript bundle when a release misbehaves.

Update Behavior

Understand how updates are discovered, downloaded, and applied.