ONESS · Beta Guide
Home Join Beta

ONESS — Quick Beta User Guide

Everything you need to know in five minutes. Install, first-run setup, Dashboard tour, opt-in features, and how to send feedback.

Last updated 13 October 2026 · covers Build 75+

1 What ONESS does

ONESS reads your Apple Watch — SpO₂, heart rate, HRV, respiratory rate, activity — and computes a daily O₂ Adequacy Score (OAS) on a 0–100 scale. Your personal wellness reflection, not a medical device.

You see how oxygen is flowing through your day, your night, and your longer trends. The app frames every number with honest context — including how many real sensor readings it's based on, and when it's interpolating between them.

Important — ONESS is a wellness app. It does not diagnose, treat, cure, or prevent any medical condition. For any health concern, consult a clinician. If your SpO₂ reads below 90% and you feel unwell, contact emergency services.

2 Install

You'll need an iPhone running iOS 17 or later, and ideally an Apple Watch Series 6 or later with Blood Oxygen enabled in the Watch app.

  1. Install Apple's TestFlight app from the App Store if you don't already have it.
  2. Tap the link below on your iPhone to join the ONESS beta:

Join the ONESS Beta on TestFlight

Once accepted, TestFlight downloads the latest build (currently 0.42.0 / Build 75+). TestFlight auto-updates ONESS whenever a new build is approved — you don't need to do anything.

3 First-run setup (5 minutes)

  1. Open ONESS. Tap "Sign in with Apple" on the welcome screen. Apple handles the login; ONESS never sees your Apple ID password.
  2. Grant HealthKit permissions. ONESS asks for read access to SpO₂, Heart Rate, HRV, Respiratory Rate, Sleep, and a few others. Granting all of them gives you the most complete experience.
  3. Fill in Lifespan basics (optional but recommended). On the Lifespan tab, enter your age, sex, weight, height. These calibrate the OAS to your personal baseline.
  4. Tap Sync on the Sync tab. First sync pulls the past 24 hours of HealthKit data and computes your first OAS. If you don't have Apple Watch data yet, use "Load 7 days of demo data" in Settings to see the app with placeholder readings.
Tip: wear your Apple Watch overnight with Sleep Focus enabled. That's when the richest SpO₂ sampling happens — typically 10–30 readings across the night vs. 1–3 per hour during the day.

4 Dashboard tour

The Dashboard is where you live day-to-day. Top to bottom:

Hero gauge

Semicircular gauge showing your latest OAS reading (0–100) with a tier capsule (Optimal / Steady / Borderline / Needs attention). The subtitle shows how many syncs today.

24-hour clock

A polar clock showing OAS per hour of today. Rainbow backdrop is decorative; the dot colors are the ones that carry the OAS tier meaning.

Trends row

Tap to open the trend sheet — switch between Today, Week, Month, Year, or All. Tap any point in the trend chart for a per-day breakdown.

Fitness vitals (6 tiles)

SpO₂, HRV, VO₂max, Resting HR, Walking HR, Respiratory rate — pulled from Apple Health. Tap any tile for a plain-language explainer and a deep-link into Apple Health.

Air quality

Current outdoor PM₂.₅ / NO₂ for your location. Netherlands users get real-time data from Luchtmeetnet/RIVM; everyone else gets OpenWeatherMap.

Educational cards

Two tap-to-expand cards: "What OAS reflects" (physical scale infographic — 500 mL per breath, 540 L O₂ absorbed daily) and "Why does my OAS dip sometimes?" (5 common causes).

5 Opt-in features (OFF by default)

Two power-user features live in Settings → Sleep insights and Settings → Daytime OAS Clock. Both are off by default. Flipping either one shows a disclosure modal first time explaining exactly what the app will read.

Sleep insights (Module H)

  • Morning card on Dashboard showing a SleepOAS score (0–100) with four sub-scores: Saturation, Rhythm, Breathing, Architecture
  • Linear or circular hypnogram visualization (toggle at the top of the card) with per-stage OAS numbers embossed inside each contiguous stage block
  • Honest-sampling footer: tells you how many real SpO₂ spot checks the score is based on
  • Backfill last 7 nights button → scores your week in one shot and shows a mini-trend row
  • Rescore last night button → re-runs the compute with the latest signals from HealthKit

Daytime OAS Clock (Module I)

  • Replaces the hourly 24-hour clock on the Dashboard with a minute-granular OAS trace
  • Dots mark each real SpO₂ sample Apple Watch captured; segments between are linearly interpolated
  • Compute from past 16 hours button in Settings
  • Optional air-quality overlay as a secondary ring
Honest limit: Apple Watch samples SpO₂ only periodically (~1-3/hour daytime, ~2/hour overnight). Both features use linear interpolation between real readings. The sample-count footer tells you exactly how many real measurements the score is based on — never trust the between-dot curve as true measurement.

6 Other tabs

Sync tab

Manual sync button, 13-day streak counter, context tags for the current reading (e.g. "Stuffy office," "After coffee"), latest OAS summary, Weekly Oxygen Reflection history.

Lifespan tab

A composite longevity index built from clinical values (hemoglobin, resting SpO₂, blood pressure, FEV₁, HbA1c). You can either fill these in by hand, or tap "Import from Apple Health Records" if your healthcare provider is connected to Apple Health.

Settings tab

User role picker (General wellness / Pregnancy / Surgical / Cycling citizen / Meditator / Clinician self-tracking), v2 OAS toggle, Sleep insights opt-in, Daytime OAS Clock opt-in, demo data loader, account deletion, Apple Sign-In account.

7 Known beta limitations

  • Automatic sleep trigger isn't live yet. After sleeping, you need to open the app and tap "Compute from last night" in Settings for the Sleep OAS card to populate. Automatic morning trigger lands in a later build.
  • SpO₂ coverage depends on Blood Oxygen being enabled on Apple Watch. Watch app → My Watch → Blood Oxygen → toggle ON. Overnight sampling is denser than daytime.
  • Lifespan FHIR import works only for US healthcare providers connected to Apple Health. If you don't see any records, you probably haven't connected a provider — that's expected.
  • Air quality in Taiwan + many Asia-Pacific regions falls back to OpenWeatherMap global data (lower resolution than Netherlands' Luchtmeetnet).
  • Minor UI polish items are being iterated. Font sizes, chart overlaps, and sheet transitions get touched up in nearly every build.

8 Safety and privacy

  • Not a medical device. ONESS does not diagnose, treat, cure, or prevent any medical condition.
  • SpO₂ below 90% is treated as an emergency signal. The Sync tab shows a red banner telling you to seek help if your most recent reading is below 90%. This is the only medical-grade alert in the app.
  • Opt-in by default. Sleep insights and Daytime OAS Clock are off until you explicitly turn them on in Settings.
  • Data stays on-device by default. You can enable server sync as a nested toggle under each opt-in feature; it's off unless you turn it on.
  • Account deletion wipes everything. Settings → Account → Delete my account removes your profile, sync history, group memberships, and backend records.
  • Full privacy policy: oness-legal.pages.dev

9 Send feedback

Beta testers are the most important early users ONESS has. If you hit anything weird, confusing, or wrong, please tell us:

  • In-app crash reports: tap "Share" on TestFlight's crash dialog — Apple forwards the stack trace directly to the dev team.
  • Written feedback via TestFlight: open TestFlight → ONESS → "Send Beta Feedback." Attach a screenshot if the issue is visual.
  • Direct email: feedback goes to [email protected]. Include your build number (Settings → Advanced → shown at the bottom) and a short description.

Specifically useful: your Sleep OAS score correlating (or not) with how rested you actually felt, any UI confusion on the Dashboard, feature requests, and anything the educational cards didn't explain well.