Onset iOS¶

A premium supplement-protocol organizer for men's health, fertility, performance, recovery, and longevity.

What is Onset?¶

Onset is a native iOS app for organizing supplement routines by time of day, tracking daily intake, scanning supplement labels, and viewing lab values alongside protocol context. The production app is a general wellness organizer and information tool. FDA-gated adaptive guidance remains disabled behind feature flags until cleared.

Core Surfaces¶

Today — time-blocked supplement routine and daily completion tracking
Protocol — editable supplement protocol with modes for organization
Labs — uploaded lab values and neutral lab/protocol organization context
Journal — personal daily logging without advisory output
Watch, Widgets, Live Activities, and App Intents — companion surfaces for tracking and quick actions

Onset Pro¶

Free — up to 10 protocol items, Stack Cost, 7-day trends, and 3 bottle scans per month
Onset Pro — unlimited protocol items and scans, advanced lab/protocol organization surfaces, inventory alerts, Watch/widgets, 30-day trends, and cloud sync
Target US pricing: $7.99/month, $49/year, $99 lifetime

Live pricing is controlled by App Store Connect and RevenueCat. Local StoreKit testing is configured in The Onset.storekit.

Stack Value / retention roadmap: docs/STACK_VALUE_RETENTION_PLAN.md.

Tech Stack¶

SwiftUI (iOS 17+)
SwiftData for local persistence
@Observable (iOS 17 Observation framework)
RevenueCat for subscriptions and entitlement state
Supabase for Edge Functions, product events, scan logs, clinic-code validation, and AI-assisted lab/protocol classification
HealthKit for read-only health trend display
Watch app, Widgets, Live Activities, and App Intents for companion interactions

Setup¶

Clone the repo
Open Onset.xcodeproj in Xcode 16+
Set your Team ID and Bundle Identifier
Build and run on iOS 17+ simulator or device

Apple Watch companion: testing steps and signing notes are in WATCH_DEBUG_CHECKLIST.md.

Requirements¶

Xcode 16.0+
iOS 17.0+ deployment target
Apple Developer Program membership (for TestFlight/App Store)

Project Structure¶

Onset/
├── App/                    # App entry point, ContentView
├── Core/
│   ├── Models/             # SwiftData models and protocol/lab data types
│   ├── Engine/             # ProtocolEngine and organization logic
│   ├── Analytics/          # Product event logging
│   ├── Clinic/             # Supabase session and clinic-code integration
│   └── Subscriptions/      # RevenueCat entitlement state
├── Features/
│   ├── Today/              # Daily protocol timeline
│   ├── CheckIn/            # Daily journal inputs
│   ├── Protocol/           # Protocol management
│   ├── Labs/               # Lab import and lab value display
│   ├── LabInsight/         # Lab/protocol organization context
│   ├── Onboarding/         # First-launch flow
│   └── Settings/           # Preferences, subscriptions
├── Shared/
│   ├── Theme.swift         # Design system
│   ├── Extensions/
│   └── Components/         # Reusable UI components
└── Resources/

Current Release Scope¶

[x] Today screen with protocol timeline
[x] Recovery / Performance / Fertility organization modes
[x] Daily journal logging
[x] Protocol editor and CSV import
[x] Bottle scanner and supplement lookup
[x] Lab result import and lab value display
[x] Lab/protocol organization context
[x] RevenueCat paywall and restore flows
[x] Apple Health read-only trend display
[x] Watch, Widgets, Live Activities, and App Intents
[x] Supabase Edge Functions for scanner, events, clinic validation, and lab intelligence
[ ] Sign in with Apple and cross-device cloud sync
[ ] Public protocol marketplace and deep-link import

Legal¶

This app does not provide medical advice. Onset displays organization and reference information for general wellness purposes only.

Production Operations¶

Static production checks: python3 scripts/production_checks.py
Full release gate (local): ./scripts/release-readiness.sh
Apply SQL on R940: ./scripts/onset-db-apply.sh supabase/migrations/<file>.sql

Runbooks: - docs/PRODUCTION_READINESS_CHECKLIST.md - docs/MONITORING_ALERTS.md - docs/ROLLBACK_RUNBOOK.md