Open Wearables React Native Example App

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:

Invitation Code - Connect via invitation code (host + code → redeem → sign in)
SDK Configuration - Initialize the SDK with proper host settings
Authentication - Sign in with credentials from the dashboard
Provider Selection - On Android, choose between Samsung Health and Health Connect
Permission Request - Request health data permissions from the user
Background Sync - Enable automatic health data synchronization
Sync Status - Monitor sync progress and handle interruptions
Log Viewer - Browse SDK logs with search

Heads-up - this example uses the invitation code flow, which is not the standard way to integrate the SDK. The example app has no backend of its own, so it redeems a single-use invitation code directly against the public POST /api/v1/invitation-code/redeem endpoint to get a session. That is fine for this self-contained demo: you generate the code in your own dashboard and enter it in the app yourself, it is single-use, and the resulting token is write-only to /sdk/*, so your app_secret never touches the device.When you build your own app, use the backend token flow instead, where your backend mints and forwards the token. See the Integration Guide and Choosing an onboarding flow.

See the full flow in action

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

Running the Example App

Clone the repository

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

Install SDK dependencies

From the repository root:

npm install

Install example app dependencies

cd example
npm install

Get credentials from Open Wearables Dashboard

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

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

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

Connect and sync

Enter the host URL and invitation code
Tap Connect to redeem the code and sign in
Grant health permissions when prompted
Tap Start Sync to begin background synchronization
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

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.

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.

Trigger sync and verify

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

Troubleshooting the Example App

App crashes on launch (iOS)

Make sure you’re running on a physical device, not the simulator. HealthKit is not available in the iOS Simulator.

No data syncing

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

Xcode signing errors (iOS)

Select your development team in Xcode
Update the bundle identifier to something unique
Ensure your Apple Developer account has HealthKit capability

Provider not available (Android)

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

Getting started

Architecture

Health Scores

Providers

Rabts Mobile App

Sync SDK

MCP Server

Developer Guides

Configuration

Support

Open Wearables React Native Example App

Overview

Example App Source

What You’ll See

See the full flow in action

Running the Example App

Example App Code Structure

Key Code Sections

Testing the Full Flow

Troubleshooting the Example App

Next Steps

Integration Guide

Troubleshooting

​Overview

Example App Source

​What You’ll See

See the full flow in action

​Running the Example App

​Example App Code Structure

​Key Code Sections

​Testing the Full Flow

​Troubleshooting the Example App

​Next Steps

Integration Guide

Troubleshooting

Overview

What You’ll See

Running the Example App

Example App Code Structure

Key Code Sections

Testing the Full Flow

Troubleshooting the Example App

Next Steps