ReactNative SDK 4.5.1

Sample Code

The quickest and simplest way to kickstart your journey with the ReactNative SDK is by downloading and experimenting with our full-featured sample code:

• Vital Sign Sample Code

IMPORTANT

In the above sample codes, the strings __YOUR_USER_ID__ and __YOUR_API_KEY__ should be replaced by your own User ID and API Key repectively. Please contact us to obtain your User ID and API Key.

Installation

In your ReactNative project, install the SDK with the npm install or yarn add commands.

npm

npm install "https://sdk.panoptic.ai/npm/react-native-vital-sign-plugin-4.5.1.tgz"

yarn

yarn add "https://sdk.panoptic.ai/npm/react-native-vital-sign-plugin-4.5.1.tgz"

Project Integration (for iOS)

IMPORTANT

This version of the SDK requires targeting iOS 15.5 or above. If targeting iOS 12, please use SDK version 3.8.x.

Update pod's config

Some dependencies do not support the ARM simulator on Apple Silicon machines. Additionally, React Native's script may incorrectly set the deployment target for certain pods. Please update your Podfile as follows to address these issues:

post_install do |installer|

  # ...

  # Add the following to your Podfile
  installer.pods_project.targets.each do |target|
    # Use x86 simulator
    target.build_configurations.each do |config|
      config.build_settings['ARCHS[sdk=iphonesimulator*]'] = 'x86_64'
    end
  end
end

Camera Permission

When developing for iOS, you need to allow the app to use the camera by specifying the following in the file Info.plist:

<key>NSCameraUsageDescription</key>
<string>Use for measuring vital signs</string>

TIP

In Info.plist, the string "Use for measuring vital signs" is an example description of the camera usage. You should specify your own description that matches the usage of your application.

Project Integration (for Android)

IMPORTANT

Please note that for Android, the minimum SDK version must be at least 24.

Update the android/app/build.gradle file:

android {
    // ...

    // Add the packaging options
    packagingOptions {
        pickFirst '**/*.so'
    }
}

dependencies {

    // Add the following dependencies.
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
    implementation files('../../node_modules/react-native-vital-sign-plugin/android/libs/vital-sign-engine-debug.aar')

    // ...
}

In android/gradle.properties, add:

kotlinVersion=1.8.0
newArchEnabled=false

Camera Permission

When developing for Android, you need to allow the app to use the camera by specifying the following in the file AndroidManifest.xml:

<uses-permission android:name="android.permission.CAMERA" />

What's new

4.5.1 (19-January-2026)

• Bug fixes and minor improvements

4.5.0 (16-December-2025)

• API Changes: Added precisionMode property to CameraProps for controlling measurement accuracy modes ('relaxed' or 'strict')
• API Changes: Added sdkCredentials property to CameraProps as a convenient object combining apiKey and userId
• Schema Improvements: Enhanced signal quality reporting with GoodSignalPercentage enum (Poor/Good/Excellent) replacing numeric values
• API Improvements: Made userId optional in UserInfo interface for better flexibility
• Sample Code Updates: Updated sample applications to use React Native version 0.80
• Enhanced performance for vital sign measurements with improved algorithm optimizations
• Fixed camera initialization issues on certain Android devices