Skip to main content

​
What is Nitro Version Check?

Nitro Version Check is a modern, high-performance library for checking app versions, build numbers, and update availability in React Native apps. Built with Nitro Modules, it provides synchronous access to version information with zero bridge overhead.

​
Key features

Synchronous access

Version, build number, and package name are cached at module init — no async calls, no bridge overhead.

Update checking

Semantic version comparison with granular update levels (major, minor, patch).

Install source detection

Detect whether your app was installed from App Store, TestFlight, Play Store, or sideloaded.

Zero overhead

Powered by Nitro Modules for direct C++ to JavaScript communication without the React Native bridge.

Expo compatible

Works seamlessly with Expo apps using development builds or bare workflow.

TypeScript first

Fully typed API with comprehensive documentation and autocomplete support.

​
Quick example

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

// Sync — no bridge, no async
VersionCheck.version       // "1.2.0"
VersionCheck.buildNumber   // "42"
VersionCheck.packageName   // "com.example.app"
VersionCheck.installSource // "appstore" | "testflight" | "playstore" | undefined

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

​
Get started

Installation

Install the package and configure platform-specific setup

Quickstart

Get up and running in minutes with practical examples

API reference

Explore the full API and all available methods

​
Why Nitro Version Check?

This library is a complete rewrite of the unmaintained react-native-version-check, rebuilt from scratch using Nitro Modules. Here’s what makes it different:
  • Synchronous by default — Version information is cached at startup and available immediately without async calls
  • Zero bridge overhead — Direct C++ to JavaScript communication via Nitro Modules
  • Modern architecture — Built with the latest React Native tooling and best practices
  • Actively maintained — Regular updates and support for the latest React Native versions
  • Drop-in replacement — Similar API makes migration straightforward

Build docs developers (and LLMs) love

Get started for freeTalk to us