React Native

Thryve provides React Native SDK and modules that are using the Thryve native SDKs.

The React Native wrapper for the native SDKs supports all functionalities of the native SDKs unless stated differently.

Starting from version 5.2.0, the Thryve React Native SDK, supports integration via the new Samsung Health Data for Android exclusively. Read more on the Thryve Samsung Health module

Configuration of projects

To integrate the Thryve React Native SDK into a bare React Native, follow the steps below for installing the packages. If you are using React Native Expo, please refer to the dedicated page.

Install packages

Download the .tgz package files provided by Thryve and place them in a directory inside your project (e.g. ./packages/). Then install the core SDK and the individual module packages for the integrations your app uses.

# Install the core SDK
npm install ./packages/thryve-react-native-sdk-<version>.tgz

# Install only the modules you need
npm install ./packages/thryve-react-native-hconnect-module-<version>.tgz   # Health Connect (Android only)
npm install ./packages/thryve-react-native-samsung-health-module-<version>.tgz    # Samsung Health (Android only)
npm install ./packages/thryve-react-native-apple-health-module-<version>.tgz # Apple HealthKit (iOS only)
npm install ./packages/thryve-react-native-shenai-module-<version>.tgz     # ShenAI (Android & iOS)
npm install ./packages/thryve-react-native-garmin-companion-module-<version>.tgz # Garmin Companion (Android & iOS)

Replace <version> with the version number of the package files you received (e.g. 5.3.0). After installation your package.json dependencies will reference the local .tgz paths:

"dependencies": {
  "@thryve/react-native-sdk": "./packages/thryve-react-native-sdk-5.3.0.tgz",
  "@thryve/react-native-hconnect-module": "./packages/thryve-react-native-hconnect-module-5.3.0.tgz",
  "@thryve/react-native-samsung-health-module": "./packages/thryve-react-native-samsung-health-module-5.3.0.tgz",
  "@thryve/react-native-apple-health-module": "./packages/thryve-react-native-apple-health-module-5.3.0.tgz",
  "@thryve/react-native-shenai-module": "./packages/thryve-react-native-shenai-module-5.3.0.tgz",
  "@thryve/react-native-garmin-companion-module": "./packages/thryve-react-native-garmin-companion-module-5.3.0.tgz",
}

Setup Android configuration

Configure Nexus Maven repository (android/settings.gradle)

Add the Thryve Nexus repository so Gradle can resolve the native Android dependencies. Credentials are read from android/local.properties first, falling back to environment variables — keep them out of source control.

// android/settings.gradle
def localProps = new Properties()
def localPropsFile = new File(settingsDir, 'local.properties')
if (localPropsFile.exists()) { localPropsFile.withInputStream { localProps.load(it) } }
def resolvedUser = localProps['THRYVE_NEXUS_USERNAME'] ?: System.getenv('THRYVE_NEXUS_USERNAME') ?: ""
def resolvedPass = localProps['THRYVE_NEXUS_PASSWORD'] ?: System.getenv('THRYVE_NEXUS_PASSWORD') ?: ""
def resolvedGarminGithubUserName = localProps['GARMIN_GITHUB_USERNAME'] ?: System.getenv('GARMIN_GITHUB_USERNAME') ?: ""
def resolvedGarminGithubToken = localProps['GARMIN_GITHUB_TOKEN'] ?: System.getenv('GARMIN_GITHUB_TOKEN') ?: ""

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
    repositories {
        google()
        mavenCentral()
        maven {
            url "https://nexus.external.thryve.de/repository/releases/"
            credentials {
                username = resolvedUser
                password = resolvedPass
            }
            content {
                includeGroupByRegex "com\\.thryve.*"
            }
        }
        
         //Optional, required only for Garmin Companion integration.
        maven {
            name = "GarminHealthSdk"
            url = uri("https://maven.pkg.github.com/garmin-health-sdk/android-sdk")
            credentials {
                username = resolvedGarminGithubUserName
                password = resolvedGarminGithubToken
            }
            content {
                includeGroup("com.garmin.health")
            }
        }
    }
}

Add your credentials to android/local.properties (this file should be in .gitignore):

THRYVE_NEXUS_USERNAME=YOUR_SDK_CREDENTIAL_USER
THRYVE_NEXUS_PASSWORD=YOUR_SDK_CREDENTIAL_PASSWORD
# Optional, required only for Garmin Companion integration.
GARMIN_GITHUB_USERNAME=YOUR_GARMIN_GITHUB_USERNAME
GARMIN_GITHUB_TOKEN=YOUR_GARMIN_GITHUB_TOKEN

Add Thryve SDK dependencies (android/app/build.gradle)

Add the required runtime dependencies:

dependencies {
    implementation("androidx.security:security-crypto:1.1.0-alpha06")
    implementation("io.reactivex.rxjava2:rxjava:2.2.21")
    implementation("io.reactivex.rxjava2:rxandroid:2.1.1")
    // ... your other dependencies
}

Define Android SDK versions (android/build.gradle)

Ensure your project-level build.gradle targets the required SDK versions:

ext {
    minSdkVersion = 26
    compileSdkVersion = 36
    targetSdkVersion = 36
    buildToolsVersion = "36.0.0"
}

Configure project when using Health Connect

For more details exceeding below explanations, please refer to the sample code demonstrating the SDK configuration.

Android Manifest

When using Health Connect you need to declare the that your app will query HealthConnect and display the permission rational as well as declare the data types you intend to use. Do this in your android/app/src/main/AndroidManifest.xml .

Declare only the data type your app actually reads and needs — extensive permission requests require justification during Google Play Store review. Every data type you pass to start() must have its corresponding permission declared here, otherwise Health Connect will reject the call at runtime (error 90005).

Import HEALTH_CONNECT_PERMISSIONS from @thryve/react-native-sdk/permissions as a reference for all available permission strings.

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          xmlns:tools="http://schemas.android.com/tools">

    <uses-permission android:name="android.permission.health.READ_HEART_RATE"/>
    <uses-permission android:name="android.permission.health.READ_STEPS"/>
    <uses-permission android:name="android.permission.health.READ_ACTIVE_CALORIES_BURNED"/>
    <uses-permission android:name="android.permission.health.READ_SLEEP"/>
    <uses-permission android:name="android.permission.health.READ_BLOOD_GLUCOSE"/>
    <uses-permission android:name="android.permission.health.READ_BLOOD_PRESSURE"/>
    <uses-permission android:name="android.permission.health.READ_WEIGHT"/>
    <uses-permission android:name="android.permission.health.READ_HEIGHT"/>
    <uses-permission android:name="android.permission.health.READ_OXYGEN_SATURATION"/>
    <uses-permission android:name="android.permission.health.READ_BODY_TEMPERATURE"/>
    <!-- Add further Health Connect permissions your app needs -->

    <uses-sdk tools:overrideLibrary="androidx.health.connect.client"/>

    <queries>
        <package android:name="com.google.android.apps.healthdata"/>
    </queries>

    <application ...>
        <!-- Health Connect rationale activity — required for health-connect module -->
        <activity
            android:name=".PermissionsActivity"
            android:exported="true">
            <intent-filter>
                <action android:name="androidx.health.ACTION_SHOW_PERMISSIONS_RATIONALE"/>
            </intent-filter>
            <meta-data
                android:name="health_permissions"
                android:resource="@array/health_permissions"/>
        </activity>
        <activity-alias
            android:name="AndroidURationaleActivity"
            android:exported="true"
            android:targetActivity=".PermissionsActivity"
            android:permission="android.permission.START_VIEW_PERMISSION_USAGE">
            <intent-filter>
                <action android:name="android.intent.action.VIEW_PERMISSION_USAGE"/>
                <category android:name="android.intent.category.HEALTH_PERMISSIONS"/>
            </intent-filter>
        </activity-alias>
        <!-- ... rest of application -->
    </application>
</manifest>

Health Permission resource

List the same Health Connect permissions that you declared in the manifest in android/app/src/main/res/values/health_permissions.xml .

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <array name="health_permissions">
    <item>android.permission.health.READ_HEART_RATE</item>
    <item>android.permission.health.READ_STEPS</item>
    <item>android.permission.health.READ_ACTIVE_CALORIES_BURNED</item>
    <item>android.permission.health.READ_SLEEP</item>
    <item>android.permission.health.READ_BLOOD_GLUCOSE</item>
    <item>android.permission.health.READ_BLOOD_PRESSURE</item>
    <item>android.permission.health.READ_WEIGHT</item>
    <item>android.permission.health.READ_HEIGHT</item>
    <item>android.permission.health.READ_OXYGEN_SATURATION</item>
    <item>android.permission.health.READ_BODY_TEMPERATURE</item>
    <!-- Mirror the permissions declared in AndroidManifest.xml -->
  </array>
</resources>

Permission activity

Additionally you need to create this file in your app's package directory (android/app/src/main/java/<your.package>/PermissionsActivity.kt ):

package your.app.package

import androidx.activity.ComponentActivity

class PermissionsActivity : ComponentActivity()

Replace your.app.package in above path with your actual application package name (e.g. com.example.myapp).

Configure project when using Samsung Health

When allowing users to connect to Samsung Health ensure to declare queries in your android/app/src/main/AndroidManifest.xml .

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
          xmlns:tools="http://schemas.android.com/tools">
          
    <queries>
        <!-- Samsung Health queries — include only if using samsung-health module -->
        <package android:name="com.samsung.health"/>
        <package android:name="com.sec.android.app.shealth"/>
        
        <!-- ... rest of queries, see section above for Health Connect -->
    </queries>
    
    <!-- ... rest of manifest -->
</manifest>

Setup iOS configuration

Configure the Podfile

Add the Thryve CocoaPods source in your ios/Podfile and include only the subspecs your app uses:

source 'https://git.thryve.de/thryve/Specs.git'
source 'https://github.com/CocoaPods/Specs.git'

# ... rest of Podfile setup ...

target 'YourAppTarget' do
  config = use_native_modules!

  # Include only the subspecs your app uses: 'AppleHealth', 'ShenAI'
  pod 'RNThryveSDKModule', :path => '../node_modules/@thryve/react-native-sdk',
    :subspecs => ['AppleHealth', 'ShenAI']

  use_react_native!(
    :path => config[:reactNativePath],
    :app_path => "#{Pod::Config.instance.installation_root}/.."
  )
end

After you have added the configuration, ensure to run:

cd ios && pod install && cd ..

Configure the Info.plist

Add the required usage descriptions in ios/<YourApp>/Info.plist :

<!-- Required for Apple Health only -->
<key>NSHealthShareUsageDescription</key>
<string>This app needs permission to share your health data</string>
<key>NSHealthUpdateUsageDescription</key>
<string>This app needs permission to update your health data</string>
<!-- Required for ShenAI only -->
<key>NSCameraUsageDescription</key>
<string>Camera is required for ShenAI facial health measurements</string>
<!-- Required for Apple Health background delivery -->
<key>UIBackgroundModes</key>
<array>
  <string>fetch</string>
</array>

Configure the required entitlements

When using Apple Health add the following HealthKit entitlements in your ios/<YourApp>/<YourApp>.entitlements .

<key>com.apple.developer.healthkit</key>
<true/>
<key>com.apple.developer.healthkit.background-delivery</key>
<true/>

Common issues

iOS build error: Typedef redefinition with different types in RCT-Folly/folly/portability/Time.h

Some users have reported the following error when building for iOS:

RCT-Folly/folly/portability/Time.h:52:17: Typedef redefinition with different types
('uint8_t' (aka 'unsigned char') vs 'enum clockid_t')

Option 1: Add the following sed command to your post_install block in ios/Podfile:

post_install do |installer|
  # ...existing post_install steps...
  sed -i -e $'s/__IPHONE_10_0/__IPHONE_13_0/' Pods/RCT-Folly/folly/portability/Time.h
end

Option 2: If the above does not resolve the issue, open ios/Pods/RCT-Folly/folly/portability/Time.h and comment out the offending line:

// typedef uint8_t clockid_t;

Migrating to React Native SDK 5.2.0+

Breaking changes

Samsung Health data types replaced

The entire ThryveSamsungHealthDataType enum has been replaced to align with the new Samsung Health data model. All previous values are removed with no backwards-compatible aliases.

You must update every reference in your app to use the new values listed in the ThryveSamsungHealthDataType reference.