Expo | Sahha Docs

Set up your platform projects and add the Sahha SDK to your Expo app.

Development build required

The Sahha SDK uses native platform code for Apple Health and Health Connect. Expo Go does not support native modules , so you must use an Expo development build .

Prerequisites

Your project must support:

Expo: Development build (not Expo Go)
iOS: iOS 15 or above, Swift 5 or above
Android: compileSdk 36 or above, Kotlin 1.9.24 or above — see full Android requirements

If you need to add Expo to an existing React Native project, see Installing Expo modules .

Set Up Platform Projects

Expo apps target both iOS and Android, so you need to complete the platform-specific setup for each. These guides cover Xcode capabilities, manifest permissions, and everything your project needs before the SDK can collect health data.

Generate the platform folders if they don't exist yet:

$ npx expo run:ios -d
$ npx expo run:android -d

iOS Platform Setup

Enable HealthKit, background delivery, background processing, and add usage descriptions in Xcode

Android Platform Setup

Add Health Connect permissions to your AndroidManifest.xml

Install the Library

Install the Sahha SDK and the Expo dev client:

$ npm i sahha-react-native
$ npx expo install expo-dev-client

Install the native iOS pod

Install CocoaPods

You need CocoaPods to install the native iOS library. Visit CocoaPods to install it if you don't have it yet.

$ cd ios && pod install && cd ..

Import the Module

Import Sahha in any file where you use the SDK:

import Sahha, { SahhaEnvironment, SahhaSensor } from 'sahha-react-native';

Next Steps

Continue to Step 2) Configure Settings to set your environment and notification preferences.