Skip to main content

Install the package

Install react-native-nitro-version-check using your preferred package manager:
npm install react-native-nitro-version-check

Peer dependencies

This library requires react-native-nitro-modules version 32.0 or higher. If you don’t already have it installed, add it to your project:
npm install react-native-nitro-modules

Platform setup

1

iOS: Install pods

Navigate to your iOS directory and install the native dependencies:
cd ios && pod install && cd ..
This will link the native Nitro module to your iOS project.
2

Android: Rebuild the app

For Android, the native module will be automatically linked. Simply rebuild your app:
npx react-native run-android
3

Verify installation

Import the library in your app to verify it’s working:
import { VersionCheck } from 'react-native-nitro-version-check'

console.log(VersionCheck.version)
If you see your app version logged, the installation was successful.

Expo compatibility

Nitro Version Check works with Expo apps using development builds or bare workflow. It does not work with Expo Go due to native module requirements.
If you’re using Expo, you’ll need to create a development build:
eas build --profile development --platform all
The library includes an Expo config plugin that will automatically configure your app. No additional setup is required beyond installing the package and rebuilding.

Troubleshooting

If you encounter issues during installation:
Clean build: Try cleaning your build folders and reinstalling dependencies:
# iOS
cd ios && rm -rf Pods Podfile.lock && pod install && cd ..

# Android
cd android && ./gradlew clean && cd ..
  • Metro bundler: Restart Metro with a clean cache:
    npx react-native start --reset-cache
    
  • Rebuild: Completely rebuild your app after installation:
    npx react-native run-ios
    npx react-native run-android
    

Build docs developers (and LLMs) love