Features

OpenVitals is a local-first Android app for Health Connect data, activity logging, imports, and simple on-device insights. This index points to current implemented behavior. Proposal and future-work notes live in Proposals.

Use the feature map when you need the route/widget/package mapping. The root feature inventory remains the detailed checklist.

Dashboard And App Experience

• Health Connect metrics dashboard: summary widgets and focused metric detail entry points.
• Non Health Connect metrics dashboard: local derived views such as cardio load, readiness, Body Energy, and sleep recovery context.
• Metric detail customization: reorder dashboard widgets, manual entry widgets, and metric detail sections.
• Home screen widgets: Android launcher widgets for metric summaries, readiness, Body Energy, Today Vitals, and quick beverage logging.
• Onboarding and permissions: first-run Health Connect setup, permission categories, and privacy expectations.
• Settings and preferences: language, units, theme, body profile, goals, reminders, Health Connect access, imports, sensors, phone-to-phone sync, and diagnostics.
• Privacy, support, and diagnostics: local-first privacy model, diagnostics surfaces, support links, and health disclaimer.
• Achievements: local badge progress for supported wellness categories.

Health Metrics

• Activity metrics: steps, distance, calories, active calories, floors, elevation, wheelchair pushes, workouts, and cardio-load context.
• Sleep tracking: sleep period overview and sleep-session detail flow.
• Sleep score and recovery: sleep score, sleep efficiency, recovery details, and confidence.
• Daily readiness: Body Energy, Training Readiness, HRV status, stress context, and adaptive guidance.
• Body Energy: selected-day energy timeline, calibration, confidence, dashboard support, and widgets.
• Heart and vitals: heart rate, resting heart rate, HRV, blood pressure, SpO2, VO2 max, respiratory rate, body temperature, blood glucose, skin temperature, and Today Vitals.
• Heart rate recovery: the guided test, the marks, quality verdicts, and how effort is judged.
• Body metrics: weight, height, BMI, body fat, lean mass, BMR, bone mass, body water mass, and FFMI context.
• Nutrition: calories in, protein, carbohydrates, fat, and selected nutrient totals.
• Hydration: hydration period detail, entry history, goals, and reminder controls.
• Mindfulness: mindfulness period detail, session history, goals, reminders, and manual-entry relationship.
• Cycle tracking: supported Health Connect cycle records in dashboard and period detail views.
• Medical records: FHIR medical records in Health Connect, shown as received, with FHIR and Apple Health import and FHIR export.
• Statistics: period ranges, comparisons, baselines, confidence, and trends across detail screens.

Logging, Import, And Recording

• Manual entry of metrics: explicit user-entered records written back to Health Connect.
• Beverage logging and caffeine: drink logging with hydration, caffeine, presets, custom catalog choices, and selected nutrition defaults.
• Food logging: a food catalog the user builds, with a name, amount, category and nutrients per food, logged as nutrition records.
• Recording of activity: GPS and repetition-oriented activity recording before saving to Health Connect.
• Activity and training plans: planned workouts, activity setup defaults, favorite activities, repetitions, sets, and review flows.
• Bluetooth LE sensors: supported heart-rate, cadence, power, and footpod sensors during activity recording.
• GPX/KML/KMZ/TCX route import: route and indoor activity file import for review before saving.
• FIT files import: Settings Data Importers support for FIT activity, course, and workout files.
• CSV import: mapped import of body measurements, vitals, steps and nutrition from a CSV file, and the app's own workout export read back one workout a row.
• Health report export: PDF report of selected metrics built from Health Connect, to share or save.
• Sync with another phone: copying Health Connect records between two phones over Bluetooth.
• Offline maps support: PMTiles or Mapsforge packs for local activity maps.
• Elevation correction: imported routes take their altitude from SRTM tiles stored on the phone.
• CoMaps navigation context: live CoMaps turn-by-turn guidance while recording GPS activities.
• Apple Health import: supported Apple Health export records written into Health Connect.
• Preloaded beverage nutrition reference: imported caffeine beverage presets, nutrition families, common serving values, and source links.
• Reminders: local hydration and mindfulness reminders with Android notification handling.

---

Generated from docs/features/README.md. Edit it there; changes made here are overwritten.