> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.
# react-native-code-push to Cresc API migration guide
Microsoft retired App Center, and CodePush with it, on March 31, 2025. If your app still calls `codePush.sync()` or wraps its root component with `codePush()`, this page maps each CodePush API, option and CLI command to its Cresc equivalent so you can port the integration line by line.
Cresc ships as the [`react-native-update`](https://www.npmjs.com/package/react-native-update) package. The release model is the one you already know: upload the native build users have installed, then publish JavaScript updates against it. For the project-level plan (auditing apps, CI, rollout), use the [migration checklist](/codepush-migration-checklist.md); this page covers the code.
## 1. Swap the native bundle URL
CodePush made the app load its downloaded bundle by replacing the bundle URL. Cresc works the same way, so the native change is a one-line swap.
**iOS** (`AppDelegate` or, from RN 0.88, `SceneDelegate`):
```swift
// Before
CodePush.bundleURL()
// After
import react_native_update
RCTPushy.bundleURL()
```
**Android** (`MainApplication`):
```kotlin
// Before
override fun getJSBundleFile(): String = CodePush.getJSBundleFile()
// After
import cn.reactnative.modules.update.UpdateContext
override fun getJSBundleFile(): String? = UpdateContext.getBundleUrl(this@MainApplication)
```
On RN 0.82 and later the Android template passes `jsBundleFilePath = UpdateContext.getBundleUrl(this)` to `getDefaultReactHost` instead. [Installation & Config](/docs/getting-started.md#configuring-the-bundle-url) has the exact snippet for every RN version, plus Expo.
Remove the CodePush deployment key from `Info.plist` and `strings.xml`. Cresc reads its `appKey` from JavaScript instead.
## 2. Replace the root wrapper
```js
// Before: react-native-code-push
import codePush from "react-native-code-push";
const App = () => ;
export default codePush({
checkFrequency: codePush.CheckFrequency.ON_APP_RESUME,
installMode: codePush.InstallMode.ON_NEXT_RESTART,
})(App);
```
```js
// After: Cresc
import { Platform } from "react-native";
import { Cresc, UpdateProvider } from "react-native-update";
import updateConfig from "./update.json";
const cresc = new Cresc({
appKey: updateConfig[Platform.OS].appKey,
checkStrategy: "onAppResume",
updateStrategy: "silentAndLater",
});
export default function App() {
return (
);
}
```
`update.json` is written by `cresc createApp` or `cresc selectApp` and holds one `appKey` per platform, the way CodePush had one deployment key per app. See [Code Integration](/docs/integration.md).
## 3. Option mapping
| CodePush option | Cresc option |
| ------------------------------- | ------------------------------------------------------------------------------- |
| `deploymentKey` | `appKey` (one per platform, from `update.json`) |
| `checkFrequency: ON_APP_START` | `checkStrategy: "onAppStart"` |
| `checkFrequency: ON_APP_RESUME` | `checkStrategy: "onAppResume"` |
| (start and resume) | `checkStrategy: "both"` (the default) |
| `checkFrequency: MANUAL` | `checkStrategy: null`, then call `checkUpdate()` yourself |
| `installMode: IMMEDIATE` | `updateStrategy: "silentAndNow"` |
| `installMode: ON_NEXT_RESTART` | `updateStrategy: "silentAndLater"` |
| `installMode: ON_NEXT_RESUME` | `updateStrategy: null`, then call `switchVersion()` from an `AppState` listener |
| `updateDialog: true` | `updateStrategy: "alwaysAlert"` or `"alertUpdateAndIgnoreError"` |
| `updateDialog` text overrides | `updateStrategy: null` and render your own UI with `useUpdate()` |
| `codePush.disallowRestart()` | `beforeReload` returning `false` cancels a pending reload |
All options are listed in the [API reference](/docs/api.md).
## 4. Method mapping
`useUpdate()` must be called from a component rendered inside ``.
| CodePush | Cresc (`useUpdate()` unless noted) |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------- |
| `codePush.sync()` | The built-in flow driven by `checkStrategy` and `updateStrategy` |
| `codePush.checkForUpdate()` | `checkUpdate()`, result in `updateInfo` |
| `remotePackage.download(progressCallback)` | `downloadUpdate()`, progress in `progress` or `useUpdateProgress()` |
| `localPackage.install(InstallMode.IMMEDIATE)` | `switchVersion()` |
| `localPackage.install(InstallMode.ON_NEXT_RESTART)` | `switchVersionLater()` |
| `codePush.notifyAppReady()` | Automatic (`autoMarkSuccess: true`); call `markSuccess()` if you turn it off |
| `codePush.restartApp()` | `restartApp()` |
| `codePush.getUpdateMetadata()` | `currentVersionInfo` and `currentHash` |
| `codePush.clearUpdates()` | `resetToPackagedBundle()` |
| `remotePackage.isMandatory` | Put a flag in the version's `metaInfo` ([pattern](/docs/bestpractice.md#using-meta-info)) |
| `remotePackage.description` | `updateInfo.description` |
A manual check-download-install flow that used to be built on `checkForUpdate` looks like this in Cresc:
```js
import { useUpdate } from "react-native-update";
function UpdateButton() {
const { checkUpdate, downloadUpdate, switchVersion, updateInfo } = useUpdate();
const onPress = async () => {
await checkUpdate();
};
if (updateInfo?.update) {
return (