Owner: Louis Lagrange

Prerequisites (~2min)

  • A running React Native app, preferably started with the generator
  • A compatible React Native version (see compatibility table)

What is CodePush

A React Native app is composed of JavaScript files and any accompanying images, which are bundled together by the packager and distributed as part of a platform-specific binary (i.e. an .ipa or .apk file). Once the app is released, updating either the JavaScript code (e.g. making bug fixes, adding new features) or image assets, requires you to recompile and redistribute the entire binary, which of course, includes any review time associated with the store(s) you are publishing to.
CodePush allows to rebuild and push only the modified JS code.
  • Faster builds
  • Easier to update: no need to download the whole app again on HockeyApp
  • See deployment history and statistics
  • Easy rollbacks
  • If you enable it in production, you can install updates silently and automatically
  • You rely on Microsoft Azure's servers
Here's an example, where we enabled it on staging in order to speed up development (at the bottom of the screen).
Code Push


1. Install the AppCenter cli (~1 min)

yarn global add appcenter-cli
# or npm install -g appcenter-cli
appcenter -v should give you a version.

2. Login into AppCenter (~4 min)

Login with your GitHub or Google account:
appcenter login
You should see your profile info with appcenter profile list.

3. Configure CodePush on AppCenter's servers (~5 min)

# Create the apps
# You can also do it via
appcenter apps create -d <MyApp>-Android -o Android -p React-Native
appcenter apps create -d <MyApp>-iOS -o iOS -p React-Native
# Invite your team members to the apps
# Configure the CodePush Staging deployment
appcenter codepush deployment add -a <owner>/<MyApp>-Android Staging
appcenter codepush deployment add -a <owner>/<MyApp>-iOS Staging
# Save the Staging tokens for later use
appcenter codepush deployment list -a <owner>/<MyApp>-Android
appcenter codepush deployment list -a <owner>/<MyApp>-iOS
Check: you have written down the deployment keys in a temporary file.

4. Install the react-native module (~5 min)

Find out the adequate version of react-native-code-push using the supported-react-native-platforms section in the react-native-code-push documentation.
# Add the npm dependency
yarn add react-native-code-push@<your.version>
# Link the native modules. Paste your Staging tokens when prompted.
react-native link react-native-code-push
react-native link command adds a pod in your Podfile.
  • If you don't already have React in your Podfile, it is recommended to remove the added line, commit, and follow the Microsoft tutorial here, paragraph Plugin Installation (iOS - Manual).
  • If you already have React in your Podfile, make sure to bundle exec pod install in order to update Podfile.lock
Check: your app builds on both Android and iOS, in debug and release mode.

5. Update your code (~35 min)

Update App.js (~10 min)

// @flow
import React, { Component } from 'react';
import CodePush from 'react-native-code-push';
import { ENV } from 'MyApp/environment'
class App extends Component {
render() {
return <Scenes />;
const codePushOptions = {
checkFrequency: CodePush.CheckFrequency.MANUAL,
const AppComponent = ENV === 'staging' ? CodePush(codePushOptions)(App) : App;
export default AppComponent;
Check: Manually set "ENV" to staging and check the logs on iOS and Android. You shouldn't see any warning for CodePush.

Add CodePushUpdateButton.js (~5 min)

You can put the update process on any page you like, or even check if an update is available with a long press somewhere... It is up to you and your PO.
import React, { Component } from 'react';
import { Text, TouchableOpacity } from 'react-native';
import CodePush from 'react-native-code-push';
class CodePushUpdateButton extends Component {
state = {
info: null,
status: null,
mismatch: false,
componentDidMount() {
if (!CodePush) return;
CodePush.getUpdateMetadata().then(update => {
if (!update) return;
let info = update.label;
if (update.description) {
info += ' (' + update.description + ')';
lookForUpdate = () => {
updateDialog: {
appendReleaseDescription: true,
descriptionPrefix: '\n\nChangelog:\n',
installMode: CodePush.InstallMode.IMMEDIATE,
SyncStatus => {
switch (SyncStatus) {
case CodePush.SyncStatus.CHECKING_FOR_UPDATE:
this.setState({ status: 'Checking for update' });
case CodePush.SyncStatus.AWAITING_USER_ACTION:
this.setState({ status: 'Awaiting action' });
case CodePush.SyncStatus.DOWNLOADING_PACKAGE:
this.setState({ status: 'Downloading' });
case CodePush.SyncStatus.INSTALLING_UPDATE:
this.setState({ status: 'Installing' });
this.setState({ status: 'No update found' });
mismatch => mismatch && this.setState({ mismatch: true })
render() {
if (this.state.mismatch) {
return <Text style={{ fontSize: 11 }}>New version on HockeyApp</Text>;
return (
<TouchableOpacity style={{ marginLeft: 5 }} onPress={this.lookForUpdate}>
<Text style={{ fontSize: 12 }}>{this.state.status || 'Check update'}</Text>
{!! && (
<Text style={{ fontSize: 8, maxWidth: 150 }} numberOfLines={3}>
export default CodePushUpdateButton;
Add this CodePushUpdateButton somewhere in your app.
On the simulator, you should see an update button if you force the env to staging.

Create bin/ (~10 min)

yarn deploy -- -t hard should deploy your application with Fastlane. yarn deploy should deploy with CodePush.

6. Test! (~15 min)

Open your PR, merge into the main branch. Have a hard build. You can now deploy with code-push.
Bump your versions into .env.staging file before every hard deploy. If not, your JS code might try to call native libraries not present in your app.

7. Externalize the keys (optional) (~10min)

Externalize the keys in Info.plist and AndroidManifest.xml: see


You can try the CodePush documentation, and particularly the react-native section.
You should also Andon the teams with a working CodePush process: