Support

Body Vitals: Health Widgets

4.0 | iOS 26.0+

GETTING STARTED

Setup & Permissions

How do I set up Body Vitals?

Open the app and grant HealthKit permissions when prompted. Body Vitals reads Apple Health data and does not require account creation. If other apps write into HealthKit, those signals can appear in Body Vitals automatically.

Which devices are supported?

Body Vitals supports iPhone on iOS 26.0 or later. It is not offered as an iPad app on the App Store. Apple Watch is recommended for richer signals (HRV, sleep stages, SpO2), but any source that writes to Apple Health can contribute data.

Does Body Vitals have an Apple Watch app or complications?

Yes. Body Vitals includes Apple Watch complications and a dedicated watch app (Pro). Complications can show readiness or other metrics at a glance (including Live Heart Rate as a selectable complication metric), and the watch app lets you customize which metrics appear on your watch dashboard (including an optional live heart rate tile while the watch app is open).

How do I add widgets to my home screen?

Long-press your home screen, tap the "+" button, search for "Body Vitals", and add widgets. Free includes small/medium home screen widgets and lock screen widgets. Pro unlocks large widgets and the StandBy Readiness Dial.

How do I use Body Vitals with Siri?

Just ask - no setup needed beyond opening the app once so iOS can register the shortcuts. Answers come from your last sync, so Siri responds without launching the app. The same actions are available in the Shortcuts app, on the Action Button, and as a Control Center button. Say the whole sentence, including "Body Vitals":

If Siri answers from the web instead of the app, say the full sentence rather than a shortened version - Siri matches these phrases closely, so dropping words can send the request to web search instead of Body Vitals.

Why is some data showing as "--" or unavailable?

Body Vitals only shows data that exists in Apple Health. If a metric shows "--", it means that data type has not been recorded yet. Common fixes: ensure HealthKit permissions are granted for all categories, wear your Apple Watch overnight for sleep/HRV, and make sure third-party apps are writing to Apple Health.

READINESS & SCORES

Understanding Your Data

What is the Readiness Score?

A 0-100 score computed from HRV, sleep duration, resting heart rate, SpO2, and training load. It uses adaptive calibration - the algorithm learns your personal baselines over 90 days. Higher means your body is more recovered and ready for intense activity.

What are the Composite Health Scores?

Pro includes six composite scores: Longevity, Cardiovascular, Metabolic, Circadian, Mobility, and Allostatic Load. They are surfaced in the Health Command Center large widget and companion app views. Allostatic Load (0-100, higher = more physiological burden) measures cumulative multi-system stress from HRV, sleep debt, training form, blood pressure, blood glucose, and wrist temperature. Each score has a detail view with research citations.

What is the Zone 2 Training Tracker?

Pro feature in the Activity tab. It automatically identifies Zone 2 workouts from the raw heart rate data recorded during workouts in Apple Health - no manual zone entry needed. It uses the scientific definition (65-75% of estimated true max HR per San Millan and Brooks 2018) and cross-references your VO2 Max for accuracy. Works with any app or device writing heart rate data to HealthKit.

What is the Acute:Chronic Workload Ratio?

Pro feature visible inside the Training Load detail view. It compares your 7-day rolling training load to your 28-day rolling load. A ratio above 1.5 indicates High Risk (associated with 2-4x higher injury risk in research by Gabbett 2016, BJSM). The optimal range is 0.8-1.3. It helps you identify when training is ramping too fast relative to your adaptation capacity.

What is the Longevity Habit Scorecard?

Pro feature accessed via the Longevity composite score. It calculates a weekly 0-100 score across five longevity pillars: Zone 2 cardio (150+ min/week), strength training (2-3x/week), sleep quality, stress and HRV management, and metabolic health. Each pillar shows your actual data and a progress bar so you can see where to focus. Resets weekly.

What is Menstrual Cycle Phase Intelligence?

Pro feature that reads menstrual flow data from Apple Health and identifies your current cycle phase (Menstrual, Follicular, Ovulatory, Luteal) based on your own history - not a generic 28-day estimate. The main place to find it is the dedicated Cycle Phase card in the Recovery tab, and a secondary badge appears inside HRV detail when cycle context explains a lower HRV reading as expected variation rather than an anomaly. If Apple Health has menstrual flow data but there are not enough recent entries to estimate the current phase confidently, Body Vitals still shows the feature with a fallback state instead of hiding it. This feature only activates when cycle data exists in HealthKit; it never relies on your reported biological sex.

What is the Neural AI Health Coach?

Pro feature in the Health tab. It is a conversational AI coach running entirely on your iPhone using Apple Foundation Models (iOS 26) - no data is sent to any cloud service. You can ask plain-language questions ("should I train today?", "why is my HRV low?") and get answers grounded in your current Apple Health data. Chat history is stored locally on your device and can be cleared at any time.

What is Med Bay?

Pro feature that shows the medications you track in Apple Health as a living record: adherence, a 30-day taken / skipped / missed dose ribbon, your actual dose times, streaks, and miss patterns. Alongside each one, its measured association with your next-morning HRV, resting heart rate, and readiness - reported only when the sample size and effect size clear an evidence gate, with honest "no clear effect" verdicts. Logging stays in the Apple Health app: Body Vitals reads your medication data and never writes it. These are observed associations in your own data, not medical advice - never change how you take a medication based on this screen.

What is the Experiment Lab?

Pro feature for running a structured 2-4 week n-of-1 experiment on yourself. Pick a habit - magnesium before bed, an earlier dinner, a daily walk - mark the days you did it, and your own data delivers the verdict. Evidence strengthens from preliminary to strong as days accumulate, so you find out whether something actually works for you rather than relying on general advice.

What is the Readiness Radar?

Five horizontal bars (HRV, Sleep, RHR, SpO2, Load) showing your readiness sub-scores. Each bar is color-coded (green, amber, red). Pro shows composite health scores on the dashboard without blur; free users see blurred previews with Upgrade to Pro where those sections appear.

Which widgets are interactive?

Interactive behavior varies by widget type. Examples include telemetry toggles, Sleep Architecture stage/trend toggles, StandBy Readiness Dial insight/workout switching (Pro), and Weekly Pattern large widget cell selection (Pro). The in-app Weekly Pattern heatmap on the dashboard is included in Free.

How does AI Coaching work?

Pro feature. Body Vitals has two AI coaching modes. AI Daily Coaching generates structured daily insights (Readiness, Sleep, Activity, Body & Heart) shown as cards on the Health tab and as chips on the Health Command Center widget - refreshable on demand. Neural - AI Health Coach is a conversational interface where you can ask open-ended questions and get answers grounded in your live HealthKit data. Both use Apple Foundation Models running on-device. No health data is sent to any third-party AI service.

Does Body Vitals send my health data to AI services?

No. Body Vitals does not send your health data to any third-party AI service. AI Coaching uses Apple Intelligence (Apple Foundation Models), Apple's native framework. Depending on device settings and the request, Apple Intelligence may use Private Cloud Compute, which is governed by Apple's privacy and security policies.

PRICING

Tiers

Free Tier

Core health dashboard with small/medium home screen widgets, lock screen widgets, 20+ HealthKit metrics with detail views and metric trends (1W / 1M / 6M / 1Y) plus trend summary cards, weekly digest on the dashboard, monthly digest context in detail views, goal streaks, export and share from metric detail, daily readiness score, VO2-aware workout recommendation, health anomaly timeline, Weekly Pattern heatmap on the dashboard (companion app; same grid as the Pro large widget), and Matte Black theme. Free forever.

Pro Tier - subscription or lifetime

Everything in Free, plus large widgets (Health Command Center with six composite scores, Weekly Pattern on the home screen), StandBy Readiness Dial, Recovery Forecast, Readiness Radar, full AI Daily Coaching, Neural - AI Health Coach (conversational), per-metric AI insights, Apple Watch complications + watch app, Zone 2 Training Tracker, Acute:Chronic Workload Ratio, Allostatic Load Score, Longevity Habit Scorecard, Menstrual Cycle Phase Intelligence, Training Load & Form (CTL, ATL, TSB), Strength Training Load, Biological Age, Personal Records, Activity Horizon, Sleep Debt, Daily Capacity, Focus Readiness, Trends & Correlations, Morning Briefing notifications, Workout Debrief, Custom Dashboard (50+ metric slots), and five additional themes (six total). New purchases on the App Store are a weekly or yearly auto-renewable subscription, or a one-time lifetime unlock (no free trial). If you already bought Pro at the original one-time price, you keep full Pro forever at no extra cost.

Is there a subscription?

Yes for new customers: Pro can be a weekly or yearly subscription, or a one-time lifetime purchase. Manage or cancel subscriptions in your Apple ID account (Settings on iPhone or App Store). Early buyers who purchased the original lifetime Pro are not charged again.

Can I share Pro with my family?

Yes. Body Vitals Pro supports Apple Family Sharing - one purchase (subscription or lifetime) covers up to 6 family members. Turn on Family Sharing for your group in Settings on iPhone; eligible members get Pro unlocked automatically, with no extra purchase. If a member's device does not unlock immediately, use Restore Purchase on the paywall.

DATA & PRIVACY

Privacy

Does Body Vitals collect my data?

Body Vitals does not require an account and keeps core health processing on your device. Health data comes from Apple Health; what the app stores for widgets stays on your iPhone. Read our full Privacy Policy.

How do I delete my data?

Delete the app to remove Body Vitals local app storage. Health data remains managed in Apple Health. Body Vitals reads HealthKit data and may write workout/activity data as described in app permission strings.

TROUBLESHOOTING

Common Issues

Widgets are not updating

iOS controls widget refresh frequency. You can force a refresh from Settings inside the app. Also ensure the app has background refresh enabled in iOS Settings > General > Background App Refresh.

Readiness score says 0 or looks wrong

The readiness engine needs HRV and sleep data as minimum inputs. If you don't have an Apple Watch or a device that provides these, some signals will score 0. The engine also needs 7-14 days of data to establish your personal baseline for accurate calibration.

AI Coaching shows "not available"

AI Coaching needs a compatible iPhone and iOS 26 or later. If your device does not support it, that part of Pro will not be available.

Contact Us

For support requests, feature suggestions, or bug reports:

Email: escapethematrix.app@outlook.com

Suggested subject (matches app): [Support/Feature Request]

We typically respond within 48 hours.