AuraHealth is a pioneering iOS application that empowers individuals to take control of their medication regimens like never before. By harnessing the power of HealthKit data and advanced analytics, AuraHealth provides users with a personalized understanding of how their medications affect their physiological state.

Medical Disclaimer:

Important note: AuraHealth is an information tool designed to support informed decision-making, not replace professional medical advice. Always consult your physician before making changes to your medication regimen.

AuraHealth doesn't just analyze "before and after" data; it uses a cutting-edge Difference-in-Differences (DiD) engine to provide a precise measurement of the medication's impact, isolating the signal from natural circadian rhythms and environmental factors.

Pharmacokinetic Alignment:

The app leverages a built-in registry of half-lives and $T_{max}$ values to determine the optimal analysis window for each medication. This ensures that users receive accurate insights into their physiological response.

Circadian Baseline:

AuraHealth constructs a synthetic control by averaging the last 14 days of data for the exact same time of day, weighted toward recent days. This helps eliminate noise and provide a more reliable baseline for comparison.

Noise Cancellation:

The app features several innovative features to minimize errors:

  • Workout Filtering: Automatically excludes biometric spikes during recorded physical activity.
  • Washout Logic: Prevents data contamination by excluding periods where previous doses are still metabolically active.
  • Statistical Significance: Calculates Z-scores and p-values (via Welch's T-Test) to determine if a change is a genuine physiological response or a random fluctuation.

Dual Analysis Modes:

AuraHealth offers two primary analysis modes:

  • Acute: For "as needed" (PRN) medications, such as Ibuprofen or Caffeine.
  • Maintenance: For chronic medications, comparing post-dose levels against a pre-dose same-day baseline.

Comprehensive Biometrics:

The app supports a range of biometric data points:

  • Resting Heart Rate (RHR)
  • Blood Glucose
  • HRV (SDNN)
  • Respiratory Rate
  • Sleep Efficiency
  • Deep Sleep Duration

Clinical Alerts:

AuraHealth automatically flags biometrics that cross safety thresholds, ensuring users are alerted to any potential concerns.

Confidence Scoring:

The app assigns a proprietary confidence score based on data density and sensor quality, filtering out manual entries to provide accurate insights.

Background Processing:

AuraHealth utilizes HealthKit Observer queries to analyze data even when the app is closed, ensuring seamless integration with users' daily routines.

Data Sovereignty:

AuraHealth prioritizes user data security by:

  • Zero Cloud: Explicitly disabling CloudKit syncing and keeping health data local.
  • Local Persistence: Using SwiftData with a local-only configuration for secure storage.
  • On-Device Analytics: Performing all statistical computations locally using the Accelerate framework.

Development Details:

AuraHealth is built on the principles of swift app development, utilizing:

  • UI: SwiftUI (Charts, NavigationStack)
  • Database: SwiftData
  • Health Integration: HealthKit (Anchored Object Queries, Background Delivery)
  • Math: Accelerate Framework (vDSP, Linear Algebra for T-Test approximations)

System Requirements:

To develop and run AuraHealth:

  • Xcode 15.0+
  • iOS 17.0+
  • A physical iPhone (HealthKit data is limited on simulators)

Getting Started:

Clone the repository:

git clone https://github.com/tomwolfe/AuraHealth.git

Open AuraHealth.xcodeproj.

Ensure you select your Development Team in the "Signing & Capabilities" tab. The app requires:

  • HealthKit (Requires Apple $99/year developer account)
  • Background Modes (Background Fetch)

Authorization:

Grant permissions for the specific biometrics you wish to track.

Library Setup:

Add medications to the "Library" to define their $T_{max}$ and half-life.

Logging:

Tap + to log a dose. AuraHealth will automatically schedule a background analysis for when the medication reaches peak plasma concentration.

Review:

Open an impact record to see the Temporal Response Chart, which overlays your actual biometric response against the expected circadian range.

Distributed under the MIT License. See LICENSE for more information.

Created by Thomas Wolfe.