acme-app health report

Upgrade plan scope: Extra large

1. Stop the leaks

Leaked keys cost money and data from the moment someone finds them. Nothing else in this plan is as urgent.

• Revoke the AWS access key ID in src/App.js:6 at the provider today. Removing it from code is not enough: every installed copy of the app still contains it.
• Move every call that needs a secret behind your own backend (a Cloud Function, API route or edge function). The app should only hold keys that are designed to be public.
• Move the signing passwords out of android/gradle.properties into ~/.gradle/gradle.properties or CI environment variables; change them if the keystore ever left your control.
• The old values stay in git history. Rotation is what makes them useless; rewriting history (e.g. git filter-repo) is optional cleanup.

2. Set up a safety net

A build that compiles and launches can still crash after login or hide a button. On a real upgrade, UI flows caught three such bugs that build and launch checks missed.

• Before changing anything, write a few UI flows (Maestro is the quickest: maestro.mobile.dev): launch, sign-in with a test account, and every tab or main screen.
• Keep test credentials in environment variables, never in the repo. Never let a flow press a button that writes to production (sign-up, purchase, posting).
• Assert that no error banner or red screen appears, not only that the app is running: a native module that fails to load can leave the process alive behind a red screen.
• Run the flows on both platforms on the current version, then again at the end of every phase below.

3. Meet the Google Play target SDK

Below the required level Google Play rejects updates or hides the app from new users.

• Set targetSdkVersion = 36 and compileSdkVersion = 36 in android/build.gradle.
• Read the Android behavior changes for every API level between 34 and 36; edge-to-edge display and foreground service types are the usual surprises.
• Build a release bundle and test on a device running the newest Android version.

4. Meet App Store and Google Play requirements

These block your next store submission regardless of anything else in this plan.

• Run pod install, commit the generated PrivacyInfo.xcprivacy, and add your collected data types and tracking to it (React Native only fills in the required-reason APIs).

5. Close security gaps

Attackers read app bundles, network traffic and logs. These are the ways in this app hands them something.

• Move android:usesCleartextTraffic="true" to android/app/src/debug/AndroidManifest.xml, or allow only specific hosts with a network security config.

6. Remove legacy tooling

Leftovers from older templates break on newer React Native versions; removing them first shrinks the upgrade diff.

• When moving to React Native 0.80+, change DefaultReactHost.getDefaultReactHost(context, host) in android/app/src/main/java/com/acme/MainApplication.java to pass null as a third argument.
• In ios/Acme.xcodeproj/project.pbxproj, add -DFOLLY_CFG_NO_COROUTINES=1 and -DFOLLY_HAVE_CLOCK_GETTIME=1 to OTHER_CPLUSPLUSFLAGS (Debug and Release) before moving to React Native 0.80.
• Delete require_relative '../node_modules/@react-native-community/cli-platform-ios/native_modules' from ios/Podfile; use_native_modules! comes from React Native.
• Remove Flipper: delete the com.facebook.flipper dependencies and FLIPPER_VERSION on Android, use_flipper! / Flipper config in the Podfile, and the ReactNativeFlipper initialization code. Use React Native DevTools instead.

7. Replace blocking and abandoned packages

These packages decide how far you can upgrade. Swap them while the app still runs on its current version, so every problem has one cause.

• @react-native-community/push-notification-ios (no New Architecture support, unmaintained, native). Options: @react-native-firebase/messaging, expo-notifications. npm uninstall @react-native-community/push-notification-ios && npm install @react-native-firebase/messaging
• react-native-fs (unmaintained, native). Options: @dr.pogodin/react-native-fs, expo-file-system. npm uninstall react-native-fs && npm install @dr.pogodin/react-native-fs

8. Update native modules on the current React Native version

Newer releases of native modules usually add New Architecture support. Pick the newest release that still supports your current React Native version; check each changelog for its minimum.

• react-native-fast-image 8.6.3 → the newest release that supports React Native 0.77 (latest is 10.0.0)
• react-native-reanimated 3.17.5 → 3.18.x (the newest for React Native 0.77; later versions come with the React Native steps below)
• @react-native-community/slider 4.5.7 → the newest release that supports React Native 0.77 (latest is 5.2.1)

9. Turn on the New Architecture on your current version

React Native 0.82 removed the legacy architecture. Switching now, before changing the React Native version, keeps the two kinds of breakage apart.

• In ios/Acme/AppDelegate.mm, add #import <ReactAppDependencyProvider/RCTAppDependencyProvider.h> and self.dependencyProvider = [RCTAppDependencyProvider new]; before calling super. Without it the switch causes a launch crash in Release.
• Android: set newArchEnabled=true in android/gradle.properties.
• iOS: set "newArchEnabled": "true" in ios/Podfile.properties.json (or run RCT_NEW_ARCH_ENABLED=1 bundle exec pod install).
• Clean everything (./gradlew clean, watchman watch-del-all, delete ios/build and ios/Pods). Switching architecture without a clean build fails on stale codegen output (e.g. missing Native…Spec classes).
• Build debug and release on both platforms.
• Click through every screen that uses a native module. Interop-layer problems show up at runtime, not at build time.

10. Raise platform minimums

Current React Native no longer supports older OS versions. Check your analytics for how many users this drops before you ship.

• Android minSdk → 24
• iOS deployment target → 15.1

11. Upgrade React Native 0.77.1 → 0.88.0

Hopping a few minors at a time gives small diffs you can actually review and bisect when something breaks.

• 0.77.1 → 0.80.0: apply the diff from https://react-native-community.github.io/upgrade-helper/?from=0.77.1&to=0.80.0, move react-native-screens 4.14–4.18.x and react-native-reanimated 3.19.x (or 4.2.x, a major migration) and react-native-gesture-handler 2.28–2.31.x, reinstall pods, build both platforms, commit.
• 0.80.0 → 0.83.0: apply the diff from https://react-native-community.github.io/upgrade-helper/?from=0.80.0&to=0.83.0, move react-native-screens 4.25.x and react-native-reanimated 4.6.x (a major migration: read its migration guide first), reinstall pods, build both platforms, commit.
• 0.83.0 → 0.86.0: apply the diff from https://react-native-community.github.io/upgrade-helper/?from=0.83.0&to=0.86.0, move react-native-screens 4.26+ and react-native-reanimated 4.8.x and react-native-gesture-handler 2.32+ (2.x line) (or 3.0+, a major migration), reinstall pods, build both platforms, commit.
• 0.86.0 → 0.88.0: apply the diff from https://react-native-community.github.io/upgrade-helper/?from=0.86.0&to=0.88.0, reinstall pods, build both platforms, commit.
• Bump react, @react-native/* packages and the Metro/Babel config to the versions the Upgrade Helper shows for the target.
• After every hop, re-check patches/react-native-svg+15.15.5.patch: still applies (npx patch-package), still needed, not undoing what the new version expects.
• If pod install reports that a React Native dependency (fast_float, hermes-engine, …) differs from Podfile.lock, delete ios/Pods and ios/Podfile.lock and install again; library pods keep the versions their podspecs pin.
• Update the Gradle version by editing android/gradle/wrapper/gradle-wrapper.properties: ./gradlew wrapper fails because the new React Native Gradle plugin already needs the new Gradle.

12. What changes in React Native 0.87 for this app

Release notes list everything; these are the changes that touch this app's own code and settings, so you can fix them in the same commit as the upgrade instead of finding them in a crash report.

• React headers imported without React/ stop the iOS build (ios/Acme/AppDelegate.h:1). Write #import <React/RCTBridge.h> instead of #import "RCTBridge.h" or #import <RCTBridge.h>; for a library, update it or patch it (patch-package). [release notes](https://reactnative.dev/blog/2026/08/11/react-native-0.87)

13. Make it usable with a screen reader and large text

Unlabeled buttons and fixed text sizes lock out people who use VoiceOver, TalkBack or larger text. In the EU, the European Accessibility Act applies to shopping and consumer banking apps since June 2025.

• Add accessibilityLabel (what the button does) and accessibilityRole="button" to the icon-only buttons: src/Header.js:8. Check each with VoiceOver or TalkBack.
• Add accessibilityRole="button" (or the role that fits) to touchables, ideally in your shared Button component.
• Go through the main flows once with VoiceOver and once with TalkBack, and once at the largest text size.

14. Update JavaScript-only packages

These do not block the upgrade. Do them last, one major at a time, following each migration guide.

• @react-navigation/drawer 6.6.2 → 7.14.4

15. Verify before you ship

An upgrade is done when the release build works on real devices, not when it compiles.

• Release builds on both platforms (./gradlew bundleRelease, Xcode Archive).
• Test on a low-end Android device and on the newest iOS and Android versions.
• Ship to internal testing / TestFlight first and watch crash-free sessions for a few days before a staged rollout.
• Run npx nativekeel again: the report should have no critical or high findings.