Getting Started

react-native-nitro-version-check is a lightweight, fast version-checking library for React Native, powered by Nitro Modules.

It's a drop-in replacement for the unmaintained react-native-version-check — rewritten from scratch for performance.

Features

• Synchronous access to version, build number, package name, and country
• Store version lookup from the App Store or Play Store
• Granular update checks — major, minor, or patch
• Install source detection — TestFlight, App Store, Play Store, or sideloaded
• Lightweight — minimal footprint, pure Swift on iOS, Kotlin on Android

Performance

Benchmarked against react-native-version-check. 100,000 iterations averaged over 5 runs on an iPhone 12:

Method	Speedup
getAllInfo	~3.1x faster
packageName	~1.6x faster
version	~1.6x faster
buildNumber	~1.6x faster
getCountry	~3.1x faster

Quick Start

First, install the package.

import {
  VersionCheck,
  getCountry,
  getStoreUrl,
  getLatestVersion,
  needsUpdate,
} from 'react-native-nitro-version-check'

// Sync properties — no await needed
console.log(VersionCheck.version)       // "1.2.0"
console.log(VersionCheck.buildNumber)   // "42"
console.log(VersionCheck.packageName)   // "com.example.app"
console.log(VersionCheck.installSource) // "appstore" | "testflight" | "playstore" | undefined
console.log(getCountry())              // "US"

// Async operations
const url    = await getStoreUrl()       // App Store / Play Store URL
const latest = await getLatestVersion()  // "1.3.0"

// Check for updates
if (await needsUpdate()) {
  Linking.openURL(await getStoreUrl())
}