Skip to main content

​
What is Synheart Wear?

Synheart Wear is a unified wearable SDK ecosystem that enables you to stream biometric data (HR, HRV, steps, calories, distance) from Apple Watch, Fitbit, Garmin, Whoop, and Samsung devices with a single, standardized API across Flutter, Android, and iOS applications.

​
Key Features

​
Cross-Platform Support

  • Flutter/Dart: Cross-platform mobile apps (iOS + Android)
  • Native Android: Kotlin SDK with Health Connect integration
  • Native iOS: Swift SDK with HealthKit integration
  • CLI Tool: Python-based local development server

​
Multi-Device Support

DeviceFlutterAndroidiOSStatus
Apple Watch✅✅ (via Health Connect)✅ (via HealthKit)Ready
Health Connect✅✅ (Native)❌Ready
WHOOP✅✅✅Ready
Fitbit🔄✅✅Mixed
Garmin🔄✅🔄Mixed
Samsung Watch📋✅❌Android Only
Oura Ring✅✅✅Via HealthKit/Connect
Legend: ✅ Ready | 🔄 In Development | 📋 Planned

​
Unified Data Schema

All platform SDKs output the same Synheart Data Schema v1.0: 
{
  "timestamp": "2025-10-20T18:30:00Z",
  "device_id": "applewatch_1234",
  "source": "apple_healthkit",
  "metrics": {
    "hr": 72,
    "hrv_rmssd": 45,
    "hrv_sdnn": 62,
    "steps": 1045,
    "calories": 120.4,
    "distance": 2.5
  },
  "meta": {
    "battery": 0.82,
    "firmware_version": "10.1",
    "synced": true
  },
  "rr_ms": [800, 850, 820]
}

​
Privacy & Security

  • Consent-First Design: Users must explicitly approve data access
  • Data Encryption: AES-256 encryption for local storage
  • Key Management: Automatic key generation and secure storage
  • No Persistent IDs: Anonymized UUIDs for experiments
  • Compliant: Follows Synheart Data Governance Policy
  • Right to Forget: Users can revoke permissions and delete data

​
Architecture

┌──────────────────────────────────────────────────────┐
│              Synheart Wear Ecosystem                 │
│         (Documentation & Specifications)             │
└──────────────────────────────────────────────────────┘
                         │
        ┌────────────────┼────────────────┐
        │                │                │
┌───────▼────────┐ ┌─────▼─────┐ ┌───────▼────────┐
│ synheart-wear- │ │synheart-  │ │ synheart-wear- │
│     dart       │ │wear-kotlin│ │     swift      │
│  (Flutter)     │ │ (Android) │ │     (iOS)      │
└────────────────┘ └───────────┘ └────────────────┘
        │                │                │
        └────────────────┼────────────────┘
                         │
                ┌────────▼─────────┐
                │ synheart-wear-cli │
                │   (Python CLI)    │
                │  + Local Server   │
                │  + ngrok Tunnel   │
                └───────────────────┘

​
SDK Architecture

Each SDK implements a consistent architecture: 
┌─────────────────────────┐
│   synheart_wear SDK     │
├─────────────────────────┤
│ Device Adapters Layer   │
│ (Apple, Fitbit, etc.)   │
├─────────────────────────┤
│ Normalization Engine    │
│ (standard output schema)│
├─────────────────────────┤
│   Local Cache & Storage │
│   (encrypted, offline)  │
└─────────────────────────┘

​
Available SDKs

​
Flutter/Dart SDK

Cross-platform SDK for iOS and Android apps.

Dart SDK Documentation

Complete guide for Flutter integration
 Installation: 
dependencies:
  synheart_wear: ^0.2.1
Version: 0.2.1
Repository: synheart-wear-dart

​
Android (Kotlin) SDK

Native Android SDK with Health Connect integration.

Kotlin SDK Documentation

Complete guide for Android integration
 Installation: 
implementation("com.github.synheart-ai:synheart-wear-android:0.1.0")
Version: 0.1.0
Repository: synheart-wear-kotlin

​
iOS (Swift) SDK

Native iOS SDK with HealthKit integration.

Swift SDK Documentation

Complete guide for iOS integration
 Installation: 
.package(url: "https://github.com/synheart-ai/synheart-wear-ios.git", from: "0.1.0")
Version: 0.1.0
Repository: synheart-wear-swift

​
CLI & Local Dev Server

Python-based development tool with OAuth, webhooks, and ngrok integration.

CLI Documentation

Complete guide for local development
 Installation: 
pip install synheart-wear-cli
Version: 0.1.0
Repository: synheart-wear-cli

​
Use Cases

​
Wellness Apps

Monitor heart rate, HRV, and activity metrics for wellness coaching: 
final synheart = SynheartWear(
  config: SynheartWearConfig.withAdapters({
    DeviceAdapter.appleHealthKit,
  }),
);

synheart.streamHR(interval: Duration(seconds: 5))
  .listen((metrics) {
    final hr = metrics.getMetric(MetricType.hr);
    if (hr != null && hr > 120) {
      showAlert('High heart rate detected!');
    }
  });

​
Mental Health Platforms

Combine with Synheart Emotion for real-time stress detection: 
// Stream biosignals from wearable
synheart.streamHRV(windowSize: Duration(seconds: 60))
  .listen((metrics) {
    final hr = metrics.getMetric(MetricType.hr);
    final rrIntervals = metrics.rrIntervals;

    // Feed into emotion engine
    emotionEngine.push(
      hr: hr,
      rrIntervalsMs: rrIntervals,
      timestamp: DateTime.now(),
    );
  });

​
Research Applications

Collect biometric data for scientific studies: 
// Configure for research-grade data collection
final synheart = SynheartWear(
  config: SynheartWearConfig.withAdapters({
    DeviceAdapter.appleHealthKit,
  }, enableLocalCaching: true, enableEncryption: true),
);

// Export data for analysis
final data = await synheart.exportData(
  startDate: studyStartDate,
  endDate: studyEndDate,
  format: ExportFormat.csv,
);

​
Roadmap

VersionGoalStatus
v0.1Core SDK (HealthKit + Fitbit)✅ Complete
v0.2Extended device support (WHOOP) & Real-time streaming (HR/HRV)✅ Complete
v0.3Extended device support (Garmin)🔄 In Progress
v1.0Public Release📋 Planned

​
Next Steps

Quick Start

Get started in 5 minutes

Dart SDK

Flutter integration guide

Kotlin SDK

Android integration guide

Swift SDK

iOS integration guide

​
Community

Author: Israel Goytom
Made with ❤️ by the Synheart AI Team