Current React Native Stack
This page summarizes the baseline used by current Instamobile React Native app packages. Use it when preparing your machine, installing dependencies, or checking whether your local tools match the app.
Quick Answer
Current apps are TypeScript-first React Native CLI projects with Expo modules. Use Node 22, Corepack, Yarn 4, React Native 0.83.6, Expo SDK 55, iOS 17 or newer, Android SDK 36, and Firebase Functions Gen2 with Node 22 when the app includes Firebase backend code.
Mobile App Baseline
| Area | Current baseline |
|---|---|
| Language | TypeScript with .ts and .tsx source files |
| Package manager | Yarn 4 through Corepack |
| React | 19.2.0 |
| React Native | 0.83.6 |
| Expo modules | Expo SDK 55 modules inside a React Native CLI app |
| Reanimated | 4.2.1 |
| Worklets | react-native-worklets 0.7.4 |
| iOS minimum | iOS 17.0 |
| Android SDK | compile SDK 36, target SDK 36, minimum SDK 24 |
| React Native architecture | New Architecture enabled |
The exact versions included with your app are the source of truth for that app.
Before changing packages, open the app folder and check package.json,
yarn.lock, ios/Podfile, and the Android Gradle files.
Required Local Tools
Install or verify these tools before running the app:
| Tool | Recommended version or source |
|---|---|
| Node.js | Node 22.x, or the version requested by .nvmrc when present |
| Corepack | Included with modern Node versions |
| Yarn | The Yarn version declared by the app package |
| Xcode | A version that supports the iOS target used by the app |
| CocoaPods | Use Bundler when the app includes a Gemfile |
| Android Studio | A recent stable version with SDK 36 installed |
| Java | The JDK version required by the Android Gradle project |
Enable Corepack once on your machine:
corepack enable
Then install dependencies from the app folder:
corepack yarn install --immutable
Common Verification Commands
Run these from the React Native app folder after installing dependencies:
corepack yarn typecheck
corepack yarn react-native config
For iOS:
bundle install
bundle exec pod install --project-directory=ios
corepack yarn ios
For Android:
corepack yarn android
Start Metro separately when you want to keep it open:
corepack yarn start
If Metro serves stale files:
corepack yarn start --reset-cache
Firebase Backend Baseline
Apps that include Firebase backend code use:
| Area | Current baseline |
|---|---|
| Runtime | Firebase Functions Gen2 |
| Node runtime | Node 22 |
| Language | TypeScript |
| Secrets | Google Cloud Secret Manager |
| App protection | Firebase App Check where supported |
| Rules | Firestore and Storage rules included with Firebase-backed apps |
Configure your Firebase project, secrets, App Check, indexes, Firestore rules, Storage rules, and mobile config files before testing Firebase-backed features.
Older JavaScript App Packages
If your app package was delivered before the TypeScript update, use the app's included README and lockfile first. Those older packages may use different Node, Yarn, React Native, Firebase, iOS, or Android requirements.
For the minimal legacy path, see: