Open Wearables Flutter 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_health_sdk.git
cd open_wearables_health_sdk/example

Install dependencies

flutter pub get

iOS Setup

Open ios/Runner.xcworkspace in Xcode and:

Select your development team in Signing & Capabilities
Ensure HealthKit capability is enabled
Update the bundle identifier if needed

Android Setup (optional)

For Android:

Ensure Health Connect is installed on the device (or Samsung Health for Samsung devices)
No additional Xcode/Android Studio configuration needed

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 the app

flutter run

For iOS: Run on a physical iOS device - HealthKit doesn’t work in the simulator. For Android: Run on a device or emulator with Health Connect installed.

Connect and sync

Enter the host URL and invitation code
Tap Connect to redeem the code and sign in
On Android, select a health provider (Samsung Health or Health Connect)
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/
├── lib/
│   └── main.dart          # Main app with SDK integration
├── ios/
│   └── Runner/
│       └── Info.plist     # HealthKit permissions & background modes
├── android/
│   └── app/
│       └── src/main/
│           └── AndroidManifest.xml
└── pubspec.yaml           # Dependencies

Key Code Sections

SDK Initialization:

await OpenWearablesHealthSdk.configure(
  host: hostUrl,
);

Sign In (via invitation code):

// Redeem invitation code to get credentials
final response = await http.post(
  Uri.parse('$host/api/v1/invitation-code/redeem'),
  headers: {'Content-Type': 'application/json'},
  body: json.encode({'code': code}),
);
if (response.statusCode != 200) {
  throw Exception('Invitation redeem failed: ${response.statusCode}');
}
final data = json.decode(response.body);

// Sign in with returned credentials
await OpenWearablesHealthSdk.signIn(
  userId: data['user_id'],
  accessToken: data['access_token'],
  refreshToken: data['refresh_token'],
);

Provider Selection (Android):

if (Platform.isAndroid) {
  final providers = await OpenWearablesHealthSdk.getAvailableProviders();
  if (providers.isEmpty) {
    throw Exception('No Android health provider is available');
  }
  final selectedProvider = providers.contains(AndroidHealthProvider.healthConnect)
      ? AndroidHealthProvider.healthConnect
      : providers.first;
  await OpenWearablesHealthSdk.setProvider(selectedProvider);
}

Request Permissions:

await OpenWearablesHealthSdk.requestAuthorization(
  types: [
    HealthDataType.steps,
    HealthDataType.heartRate,
    HealthDataType.sleep,
    HealthDataType.workout,
    // ... more types
  ],
);

Start Background Sync:

await OpenWearablesHealthSdk.startBackgroundSync();

Log Stream:

MethodChannelOpenWearablesHealthSdk.logStream.listen((message) {
  // Display in logs page
});

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 Flutter 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