health_forge_apple 0.1.1

Apple HealthKit adapter for health_forge — reads 14 health metric types from HealthKit and maps them to the unified health_forge data model.

health_forge_apple

Apple HealthKit adapter for Health Forge — reads 14 health metric types from HealthKit on iOS and maps them to the unified health_forge_core data model.

Built on health_forge_core (pure Dart data model + merge engine) and typically used with health_forge (Flutter client).

Supported metrics

Activity (4), Cardiovascular (3), Sleep (1 session with stages), Body (4), Respiratory (2) — 14 metric types total, all read-only.

Family	Metrics
Activity	steps, caloriesBurned, distanceSample, activitySession (workouts)
Cardiovascular	heartRateSample, heartRateVariability, restingHeartRate
Sleep	sleepSession with SleepStageSegments (6 HealthKit stage types aggregated + deduplicated)
Body	weight, bodyFat, bloodPressure, bloodGlucose
Respiratory	bloodOxygen, respiratoryRate

Installation

dependencies:
  health_forge: ^0.1.1
  health_forge_apple: ^0.1.1

Add HealthKit entitlement and NSHealthShareUsageDescription to ios/Runner/Info.plist. See docs/getting_started.md for full iOS setup.

Usage

import 'package:health_forge/health_forge.dart';
import 'package:health_forge_apple/health_forge_apple.dart';

final forge = HealthForgeClient()..use(AppleHealthProvider());

final auth = await forge.auth.authorize(DataProvider.apple);
if (auth.status != AuthStatus.success) return;

final records = await forge.registry
    .getProvider(DataProvider.apple)!
    .fetchRecords(
      metric: MetricType.heartRate,
      range: TimeRange(
        start: DateTime.now().subtract(const Duration(days: 1)),
        end: DateTime.now(),
      ),
    );

Related packages

Package	Purpose
health_forge_core	Pure Dart data model + merge engine (required)
health_forge	Flutter client (recommended)
health_forge_ghc	Google Health Connect adapter (Android counterpart)

License

MIT