@gj-kit/expo-workouts
A native Expo bridge for HealthKit and Health Connect workouts, routes, authorization, and incremental sync.
Current npm latest:
0.1.1
Use it when
Section titled “Use it when”Use it when an Expo app needs platform health data while retaining location collection, UI, and sync ownership.
Do not use it when
Section titled “Do not use it when”Do not use it for live GPS tracking, background location policy, or server-side health-data processing.
Golden path
Section titled “Golden path”Outcome: A native Expo app can check HealthKit or Health Connect availability and request workout access.
1. Install
Section titled “1. Install”pnpm add @gj-kit/expo-workouts2. Keep the app-owned boundary explicit
Section titled “2. Keep the app-owned boundary explicit”Add the config plugin and use a development build; Expo Go and the web cannot call the native module.
3. Start with the smallest integration
Section titled “3. Start with the smallest integration”Copy this first, then replace only the app-owned values named above.
import { getAvailability, requestAuthorization } from '@gj-kit/expo-workouts';
export async function requestWorkoutAccess() { const availability = await getAvailability(); if (availability.status === 'available') { await requestAuthorization({ read: ['workouts'] }); } return availability;}Runtime and peers
Section titled “Runtime and peers”Engines: node >=20
| Peer | Supported range | Required for |
|---|---|---|
expo |
>=56.0.0 <58.0.0 |
documented optional subpaths only |
Public subpaths
Section titled “Public subpaths”| Entry | Exported symbols |
|---|---|
Root entry |
136 |
./core |
123 |
./plugin |
1 |
./testing |
10 |
Safety boundary
Section titled “Safety boundary”This is a native module: Expo Go and web/Node are intentionally unsupported for native calls. Explain health permissions before requesting them.
API reference
Section titled “API reference”complete API reference contains every public function, class, type, constant, and error contract generated from release declarations. Each item shows its import path, release signature, and package version.