Skip to main content

​
Overview

The SDK repository includes a fully functional example app that demonstrates how to use SDK to sync Apple Health and Android health data with Open Wearables. It’s also a great way for individuals to sync their personal health data and get it into Open Wearables in minutes! Use it to test the SDK, explore the code, and see how everything works together.

Example App Source

View the example app source code on GitHub.
Don’t want to build the app yourself? Join our Discord and ask for a TestFlight beta invitation. The app will also be available in the App Store soon!

​
What You’ll See

The example app demonstrates the complete integration flow:
  1. Invitation Code - Connect via invitation code (host + code → redeem → sign in)
  2. SDK Configuration - Initialize the SDK with proper host settings
  3. Authentication - Sign in with credentials from the dashboard
  4. Provider Selection - On Android, choose between Samsung Health and Health Connect
  5. Permission Request - Request health data permissions from the user
  6. Background Sync - Enable automatic health data synchronization
  7. Sync Status - Monitor sync progress and handle interruptions
  8. Log Viewer - Browse SDK logs with search

See the full flow in action

Watch how data flows from device setup through syncing to the dashboard and API.

​
Running the Example App

1

Clone the repository

git clone https://github.com/the-momentum/open-wearables-react-native-sdk.git
cd open-wearables-react-native-sdk
2

Install SDK dependencies

From the repository root:
npm install
3

Install example app dependencies

cd example
npm install
4

Get credentials from Open Wearables Dashboard

  1. Go to your Open Wearables dashboard
  2. Create a new user or select an existing one
  3. Generate an invitation code for the user
  4. Copy the invitation code and host URL
5

Run on iOS

From the example directory:
npx expo run:ios
Run on a physical iOS device for health data sync — HealthKit is not available in the iOS Simulator.
If you encounter a signing error, update the bundle identifier to a unique value in example/app.json → expo → ios → bundleIdentifier, then regenerate the native project:
npx expo prebuild --clean
6

Run on Android

The Android SDK is distributed via Maven Local. First, generate the native project:
npx expo prebuild
Then clone and publish the Android SDK to Maven Local:
git clone https://github.com/the-momentum/open_wearables_android_sdk
cd open_wearables_android_sdk
git checkout v0.6.0
./gradlew publishToMavenLocal
Add mavenLocal() as the first entry under allprojects → repositories in example/android/build.gradle:
allprojects {
  repositories {
    mavenLocal()
    // ...
  }
}
Run the app from the example directory:
npx expo run:android
7

Connect and sync

  1. Enter the host URL and invitation code
  2. Tap Connect to redeem the code and sign in
  3. Grant health permissions when prompted
  4. Tap Start Sync to begin background synchronization
  5. Check the dashboard to see your health data appear!

​
Example App Code Structure

The example app demonstrates best practices for SDK integration: 
example/
├── App.tsx                    # Main app entry, SDK init & session state
├── components/
│   ├── SessionGroup.tsx       # Connect form (host URL + invitation code)
│   ├── ActionsGroup.tsx       # Sync controls (start/stop/sync now)
│   ├── ProvidersGroup.tsx     # Android provider selection
│   └── StatusBanner.tsx       # Sync status display
├── screens/
│   └── LogsScreen.tsx         # SDK log viewer
├── hooks/
│   └── useLogs.ts             # Subscribes to onLog / onAuthError events
├── app.json                   # Expo config (bundle ID, permissions plugin)
└── package.json               # Dependencies

​
Key Code Sections

SDK Initialization: 
import OpenWearablesHealthSDK from "open-wearables";

OpenWearablesHealthSDK.configure("https://your-api-host.com");
Sign In (via invitation code): 
// Redeem invitation code to get credentials
const response = await fetch(
  `${host}/api/v1/invitation-code/redeem`,
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ code: invitationCode }),
  }
);
const data = await response.json();

// Sign in with returned credentials
await OpenWearablesHealthSDK.signIn(
  data.user_id,
  data.access_token,
  data.refresh_token,
  null
);
Request Permissions: 
import OpenWearablesHealthSDK, { HealthDataType } from "open-wearables";

const granted = await OpenWearablesHealthSDK.requestAuthorization(
  Object.values(HealthDataType)
);
Start / Stop Background Sync: 
// Start
await OpenWearablesHealthSDK.startBackgroundSync();

// Stop
await OpenWearablesHealthSDK.stopBackgroundSync();
Sync Now: 
await OpenWearablesHealthSDK.syncNow();
Listen for SDK Events: 
import { useEvent } from "expo";

// In a React component
const onLogPayload = useEvent(OpenWearablesHealthSDK, "onLog");
const onAuthErrorPayload = useEvent(OpenWearablesHealthSDK, "onAuthError");
Or outside React with the standard addListener API: 
const subscription = OpenWearablesHealthSDK.addListener(
  "onLog",
  ({ message }) => console.log("SDK log:", message)
);

// Clean up
subscription.remove();

​
Testing the Full Flow

1

Set up Open Wearables locally (optional)

If you want to test with a local instance:
git clone https://github.com/the-momentum/open-wearables.git
cd open-wearables
docker compose up -d
Then use your local URL as the host when connecting in the app.
2

Create test data

iOS: Add some health data to Apple Health on your device:
  • Open the Health app
  • Browse → Steps → Add Data
  • Add a few data points
Android: Add data via Health Connect or Samsung Health.
3

Trigger sync and verify

  1. In the example app, tap Sync Now
  2. Check the Open Wearables dashboard
  3. Your health data should appear under the user’s timeseries!

​
Troubleshooting the Example App

Make sure you’re running on a physical device, not the simulator. HealthKit is not available in the iOS Simulator.
  • Verify your invitation code is correct and hasn’t been used already
  • Check that the host URL is the API URL (not the dashboard URL)
  • Check that your Open Wearables instance is running
  • Ensure network connectivity
  • Confirm health permissions were granted (check iOS Settings → Privacy → Health, or Android Settings → Health Connect)
  • Make sure there’s actual health data in Apple Health / Health Connect
  • Try tapping Sync Now to trigger an immediate sync
  • Check the Logs page in the app for errors
  • Select your development team in Xcode
  • Update the bundle identifier to something unique
  • Ensure your Apple Developer account has HealthKit capability
  • For Health Connect: ensure it’s installed from Play Store (pre-installed on Android 14+)
  • For Samsung Health: only available on Samsung devices with Samsung Health installed

​
Next Steps

Integration Guide

Integrate the SDK into your own app.

Troubleshooting

Common issues and solutions.