Troubleshooting

Debug builds do not receive an OTA bundle

This is expected. Debug builds should use Metro. Install a release build to verify OTA behavior.

The app rolls back after launching

Confirm that client.notifyAppReady() runs after the first successful render. It is required for rollback safety.

configure() cannot find a deployment key

• Expo: set deploymentKey in the config plugin, run expo prebuild, and rebuild.
• iOS: check NITROPUSH_DEPLOYMENT_KEY in Info.plist.
• Android: check the matching <meta-data> inside <application>.

No update is returned

Verify the project, environment, platform, runtime version, and rollout percentage. The release runtime version must match the installed native binary, unless the release targets *.

Delta download falls back to full bundle

Fallback is expected when no compatible base bundle exists or a verified patch would not save bytes. Confirm both the app configuration and upload use Delta Updates.