Support

Body Vitals: Health Widgets

Version 1.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.

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.

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 five composite scores (Longevity, Cardiovascular, Metabolic, Circadian, Mobility) surfaced in the Health Command Center large widget and companion app views.

What is the Readiness Radar?

Five horizontal bars (HRV, Sleep, Heart Rate, SpO2, Load) showing your readiness sub-scores. Each bar is color-coded (green, amber, red) so you can see which dimension is dragging your score down or holding it up.

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 cell drill-down (Pro).

How does AI Coaching work?

Pro feature. Body Vitals uses Apple Foundation Models on-device where available, with a template fallback on unsupported devices. Coaching uses your latest HealthKit metrics to provide practical daily guidance.

PRICING

Tiers

Free Tier

Core health dashboard with small/medium home screen widgets, lock screen widgets, 20+ HealthKit metrics with detail views, daily readiness score, VO2-aware workout recommendation, trend ranges, anomaly timeline, and Matte Black theme. Free forever.

Pro Tier - one-time purchase (launch framing: $19.99)

Everything in Free, plus large widgets (Health Command Center, Weekly Pattern), StandBy Readiness Dial, Recovery Forecast, Readiness Radar, weekly health heatmap, full AI coaching, per-metric AI insights, and five additional themes (six total).

Is there a subscription?

No. Pro is a one-time purchase (launch framing: $19.99) with no recurring subscription.

DATA & PRIVACY

Privacy

Does Body Vitals collect my data?

Body Vitals does not require an account and computes core insights on-device. Health data comes from Apple Health, and widget-related storage is local in the app's App Group container. 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 requires an iPhone 16 or later (devices with Apple Foundation Models support) and iOS 26.0+. On unsupported devices, the app uses template-based coaching notes instead.

Contact Us

For support requests, feature suggestions, or bug reports:

Email: escapethematrix.app@outlook.com

We typically respond within 48 hours.