← all features
008

iOS Companion App

HealthKit, CoreLocation, widgets, SwiftData offline sync, and heart rate monitoring — all on your iPhone.

The xeve iOS app extends your tracking to your iPhone. It syncs HealthKit data, detects home and work locations, provides three widget types for your home screen, and connects to BLE heart rate monitors — all with offline-first reliability.

01
01

HealthKit sync

Reads six data types from Apple Health: steps, active energy burned, resting energy, walking/running distance, heart rate, and sleep analysis.

02

Location awareness

Uses CoreLocation to detect when you are at home, at work, or at a check-in location. Geofenced regions are configurable in the app.

03

Home screen widgets

Three widget types — a small productivity score widget, a medium today overview widget, and three lock screen widget variants. All update in real-time via App Groups.

04

Offline-first sync

All data is stored locally in SwiftData with an isSynced flag. When offline, data accumulates locally and syncs automatically when connectivity returns.

05

BLE heart rate

Connect to any Bluetooth heart rate monitor directly from your iPhone. Live heart rate display with a real-time chart and session logging.

02

The iOS app is built with SwiftUI targeting iOS 17+. It uses the Supabase Swift SDK for auth and data sync. HealthKit data is queried using HKStatisticsQuery (cumulative types) and HKSampleQuery (categorical types like sleep). Location uses CLLocationManager with region monitoring for home/work geofences. SwiftData models include an isSynced boolean for offline-first architecture. Widgets use WidgetKit with shared data via App Groups (group.io.xeve.shared). The app state uses nested ObservableObjects with Combine .objectWillChange.sink forwarding. The project uses xcodegen (project.yml) for Xcode project generation.

03

Is the iOS app available on the App Store?

The iOS app is currently in TestFlight beta. It will be available on the App Store when it exits beta. You can request a TestFlight invite from the xeve dashboard.

Does the iOS app work without the Mac app?

Yes. The iOS app is a standalone companion that syncs health, location, and heart rate data independently. However, app tracking and coding analytics require the macOS app or VS Code extension.

How much battery does the iOS app use?

Very little. HealthKit sync uses background delivery which is managed by iOS for efficiency. Location monitoring uses geofences (not continuous GPS) which have minimal battery impact. BLE heart rate uses Bluetooth Low Energy which is designed for long-duration, low-power connections.

early access

get started free

free during early access. no credit card required. install the mac app and your dashboard is live in seconds.