Why Simulator Success Is Not Release Readiness
Development builds in React Native benefit from Metro bundler speed, hot reloading, relaxed network security, and local emulators with unlimited resources. But production release artifacts behave completely differently.
Hermes bytecode compilation, release keystore signing, ProGuard code shrinking, native permission requirements, and background sleep policies all come into play the moment you assemble an Android App Bundle (AAB) or iOS archive.
Gate 1: Release Code Signing and Keystore Hygiene
On Android, ensure your upload keystore is properly configured via environment variables or Gradle properties, and never committed into Git history. On iOS, verify that your Distribution Provisioning Profile matches the exact App ID and includes required entitlements (Associated Domains, Push Notifications).
// android/app/build.gradle
signingConfigs {
release {
if (project.hasProperty('MYAPP_UPLOAD_STORE_FILE')) {
storeFile file(MYAPP_UPLOAD_STORE_FILE)
storePassword MYAPP_UPLOAD_STORE_PASSWORD
keyAlias MYAPP_UPLOAD_KEY_ALIAS
keyPassword MYAPP_UPLOAD_KEY_PASSWORD
}
}
}Gate 2: Authentication Token Refresh Resilience
One of the top reasons for poor 1-star app store ratings is silent logout. When an access token expires while a user is away, does your Axios or Supabase interceptor automatically fetch a fresh session with the refresh token, or does it drop the user back to the welcome screen?
Test this explicitly: set access token expiration to 60 seconds in your test backend, open the app, lock your device for two minutes, and resume navigation. The session should seamlessly recover without friction.
Gate 3: Deep Linking & Universal Links Routing
Whether using React Navigation or Expo Router, test both cold starts (app closed completely) and warm starts (app minimized) when tapping a deep link. Verify that `apple-app-site-association` and `assetlinks.json` files are hosted over valid HTTPS without redirects on your domain.
Gate 4: Offline Resilience and Optimistic UI Safeguards
What happens when the device loses cellular connection mid-flow? If a user taps 'Submit', does the app freeze, display a raw error toast, or preserve their input and allow retry? In Tare, our habit reflection app, user entries are saved locally first before requesting AI extraction, ensuring personal words are never lost if the connection drops.
Gate 5: Store Compliance & Permission Disclosures
Both Apple App Store and Google Play require explicit privacy nutrition labels and runtime permission explanations. If your `Info.plist` requests camera or photo library access without a descriptive `NSCameraUsageDescription`, automated store ingestion will reject the binary immediately.