The React Native OTA Platform CodePush Should Have Been

Remove CodePush, install AppSpacer

Uninstall the legacy package and replace it with the AppSpacer SDK. Both packages have the same native peer dependencies so there are no additional link steps.

# remove the old package
npm uninstall react-native-code-push

# install AppSpacer
npm install react-native-appspacer

# auto-configure native files (iOS + Android)
npx appspacer setup

Replace the HOC in your App entry point

Swap out the codePush() wrapper with withAppSpacer(). The configuration shape is intentionally similar — most migrations are a direct find-and-replace.

import { withAppSpacer } from 'react-native-appspacer';

function App() {
  return <MyApp />;
}

export default withAppSpacer({
  deploymentKey: 'sk_YOUR_KEY',
  appVersion: '1.0.0',
  updateDialog: true,    // 5 built-in themes
  installMode: 'ON_NEXT_RESTART',
})(App);

(Optional) Use the React hook for custom update UI

If you built a custom update flow with CodePush's JS API, AppSpacer provides a useAppSpacer hook with the same lifecycle events — checking, downloading, installing.

import { useAppSpacer } from 'react-native-appspacer';

export function UpdateBanner() {
  const { status, progress, update } = useAppSpacer();

  if (status === 'idle') return null;

  return (
    <View style={styles.banner}>
      {status === 'downloading' && (
        <Text>Downloading update: {Math.round(progress * 100)}%</Text>
      )}
      {status === 'available' && (
        <Pressable onPress={update}>
          <Text>Tap to install update</Text>
        </Pressable>
      )}
    </View>
  );
}

Deploy your first update

Authenticate with the CLI, then push. AppSpacer calculates the delta between versions and ships only what changed — your users download kilobytes, not megabytes.

# authenticate once
npx appspacer login

# push to production (canary: 10% of users first)
npx appspacer deploy \
  --env production \
  --rollout 10 \
  --description "Fix payment screen crash"

# watch propagation in real time
npx appspacer status

Your update is live. If the crash rate spikes, AppSpacer rolls back automatically. If it looks healthy, promote to 100% with a single command.