Overview

Use CodePushGo’s Live Updates feature to update the JavaScript bundles of your app remotely, in real-time. Push JS updates directly to your users without going through the app store review process to instantly fix bugs and ship new features.

Note

Live Updates are limited to JavaScript bundle changes. If you need to update native code, such as adding or removing a plugin or changing native project configuration, you’ll need to submit a new native binary build to the app stores.

How Live Updates Work

CodePushGo’s Live Update system has two key components:

1. The CodePushGo SDK, which you install in your app. The SDK checks for available updates and downloads them in the background.

2. Channels, which let you target updates to specific groups of users. You can use channels to manage different release tracks, such as Production, Staging, and Dev.

When you upload a new JS bundle to CodePushGo and assign it to a channel, the CodePushGo SDK in apps configured for that channel will detect the update and download it. The next time the app restarts, the new bundle will be loaded.

Getting Started

To start using Live Updates, follow these steps:

1. Complete the CodePushGo Quickstart to set up your app in CodePushGo and install the CodePushGo SDK.

2. In your app code, call React NativeUpdater.notifyAppReady() after your app has finished initializing. This tells the CodePushGo SDK that your app is ready to receive updates.

3. Build your JS bundle and upload it to CodePushGo:

   npm run build
   npx @codepushgo/cli@latest bundle upload --channel=Production

4. Open your app and wait for the update to download. You can check the status with:

   npx @codepushgo/cli@latest app debug

5. Once the update is downloaded, close and reopen your app to load the new bundle.

See the Deploying Live Updates guide for more details.

Next Steps

Channels

Learn how to use channels to manage different release tracks and target updates to specific users.

Rollbacks

Discover how to roll back to a previous JS bundle version if an update causes issues.

Update Behavior

Customize how and when updates are downloaded and applied in your app.

Fast Updates

Learn how to use fast updates to speed up the update process.