Feature Inventory

This document is a functional inventory of the OpenVitals Android app. It is organized by what the user can view, what the user can insert/update/delete, and which settings are available. Watch and scale support (Garmin and Wear OS watches, the Xiaomi S400 scale) is the separate OpenWatch app, which writes what those devices record to Health Connect. An install updated from a version that still had them sees a one-time notice saying so, with a link to OpenWatch.

For the route, widget, package, and documentation mapping, see docs/features/feature-map.md.

View Data

Shared Metric Views

• View most metrics by day, week, month, or year.
• Move to previous and next periods.
• Pick a specific date from the calendar.
• Pull to refresh data from Health Connect.
• See period-aware charts:
  • Day and week views use daily or intraday chart values where available.
  • Month and year views use longer-range history/heatmap style summaries where available.
• See selected-day entry lists from charts where supported.
• See data confidence cards with coverage, sample counts, and source information.
• See period statistics, previous-period comparisons, and personal baseline insights where supported.
• See empty, permission, and error states when data is unavailable.

Dashboard

• View configurable summary widgets for the main health categories.
• View activity widgets for steps, distance, calories out, active calories, floors, elevation, wheelchair pushes, and workouts.
• View sleep, beverages, hydration, caffeine, nutrition, body, vitals, mindfulness, cycle, and cardio load widgets.
• Reorder or remove dashboard widgets through the dashboard customization flow.
• Open the relevant metric detail screen from supported widgets.

Achievements

• View unlocked and locked achievement progress.
• Filter achievements by category.
• View summary progress, tracked days, best daily steps, total distance, best daily floors, and total floors.
• View badge progress toward daily steps, lifetime distance, daily floors, and lifetime floors targets.

Beverages, Hydration, And Caffeine

• View total hydration for the selected period.
• View metric hydration totals with two decimal places in liters.
• View hydration history charts by day, week, month, and year.
• View selected-day hydration entries.
• View each entry's amount, date/time, and source.
• View active caffeine estimates, caffeine intake totals, source and time-of-day insights, and bedtime guidance when caffeine nutrition records are available.
• View configured caffeine sensitivity, daily limit, and bedtime preferences.
• View daily goal progress, goal streaks, goals met, longest streak, success rate, average daily intake, total intake, best day, previous-period comparison, and personal baseline.
• View hydration reminders and daily goal configuration from the hydration detail screen.
• View a cross-metric insight comparing hydration with weight fluctuation.
• Distinguish OpenVitals-created entries from read-only entries created by other sources.

Activity Metrics

• View steps.
• View distance.
• View calories out.
• View active calories.
• View floors climbed.
• View elevation gained.
• View wheelchair pushes.
• View each metric across day, week, month, and year ranges.
• View intraday charts for steps, calories, and active calories where data exists.
• View daily entries and aggregated daily totals.
• View daily goal progress for supported activity metrics.
• View total, daily average, best day, active days, previous-period comparison, and personal baseline.

Workouts And Activities

• View workout/activity sessions for the selected period.
• View planned workouts when Health Connect provides them.
• View workout history charts and selected-day workout lists.
• View data confidence and manual-entry counts.
• View workout goal progress in minutes.
• View total workout duration, activity count, average duration, longest workout, previous-period comparison, and personal baseline.
• View guideline/context cards for activity volume.
• View cross-metric insight comparing workouts with resting heart rate.
• View activity details including title, type, start/end time, duration, moving time, source, notes, time zones, recording method, device, record IDs, client record IDs, client record version, planned session ID, and last modified time.
• View activity metrics including steps, distance, pace, speed, recorded speed, power, cadence, calories, wheelchair pushes, floors, and elevation.
• View route previews, route point counts, start/end route points, offline maps from imported PMTiles or Mapsforge packs, map opening, and GPX, KMZ or FIT export when route data is available; the FIT carries the route with heart rate, speed and cadence beside it.
• Export or share any workout's metrics without its GPS route, as TCX or FIT (with heart-rate, speed and cadence samples) or CSV.
• View activity segments, laps, repetitions, and set information where available.
• Configure the activity recording dashboard, use Focus mode, keep the screen awake while recording, and monitor heart rate for supported strength and repetition training recordings.

Cardio Load

• View daily cardio load and weekly cardio load dashboard/detail values.
• View calculation details for the selected day.
• View TRIMP score, calculation method, heart-rate coverage, expected coverage, resting heart rate, max heart rate, heart-rate sample count, activity windows, activity minutes, and confidence/method labels.
• View explanatory context and references for the cardio load calculation.

Sleep

• View sleep duration by day, week, month, and year.
• View sleep sessions in the selected period.
• View selected-day sleep session timelines.
• View sleep stages including asleep/sleeping, light, deep, REM, awake, awake in bed, and out of bed when available.
• View data confidence, sleep goal progress, total sleep, daily average, longest sleep, nights logged, previous-period comparison, and personal baseline.
• View sleep target/context cards.
• View cross-metric insight comparing sleep with HRV.
• Review caffeine timing and bedtime guidance in the standalone caffeine detail experience. Direct caffeine insight cards inside sleep detail are planned separately.
• View sleep session details including title, notes, source, recording method, device, IDs, start/end time, duration, and stage event list.

Sleep Score And Recovery

• View recent sleep score and sleep efficiency details.
• View confidence and non-diagnostic context.
• View expandable formula/calculation details.
• View component values such as duration, efficiency, continuity, regularity, and total sleep.
• Keep missing caffeine data neutral; direct caffeine-aware sleep-score context is planned separately.
• View references used by the scoring/explanation screens.

Daily Readiness

• View a local Daily Readiness score with confidence context.
• View Body Energy and Training Readiness scores.
• Have overnight Body Energy charge reflect how well the night was slept — efficiency, time awake and deep/REM share — not only how long it lasted.
• View HRV status, intensity minutes, physiological stress level, recommended activity, activity to avoid, alternatives, strain target, and adaptive goal guidance.
• View detailed Body Energy, Training Readiness, and Stress Tracking explanation screens.
• View signal breakdowns and caveats that explain how available Health Connect data affected the recommendation.
• Move between days, open the calendar, and refresh readiness data.

Nutrition

• View calories in.
• View protein.
• View total carbohydrate.
• View total fat.
• View additional nutrient totals when present, including fiber, sugar, energy from fat, mono/poly/saturated/trans/unsaturated fat, cholesterol, vitamins, minerals, and caffeine.
• View nutrition trends by day, week, month, and year.
• View a daily average per nutrient over a week, month or year, with the period total kept alongside it.
• Choose whether nutrition averages divide by logged days only or by every day of the period.
• View selected-day nutrition entries.
• View meals with meal type, name, date/time, calories, macros, fiber, sugar, and source.
• View macro split context.
• View data confidence and metric statistics including total, daily average, best day, logged days, previous-period comparison, and personal baseline.

Calories

• View calories out.
• View active calories.
• View BMR.
• View total calories, active calories, and BMR trends.
• View daily calorie breakdown rows.
• View calculated total calories when the app is configured to combine active calories and BMR if Health Connect totals are missing.
• View daily averages and BMR reading counts.

Body

• View weight.
• View height.
• View BMI.
• View body fat percentage.
• View lean body mass.
• View BMR.
• View bone mass.
• View body water mass.
• View body metrics across day, week, month, and year ranges.
• View week, month and year as a trend line over a fitted scale, rather than a calendar of coloured days.
• View history charts and entry rows with value, source, and time.
• View latest, average, lowest, highest, reading counts, previous-period comparison, and personal baseline where applicable.
• View BMI interpretation/context.
• Distinguish editable OpenVitals weight/height/body-fat entries from read-only external entries.

Heart And Vitals

• View average heart rate.
• View resting heart rate.
• View HRV.
• View blood pressure.
• View SpO2.
• View VO2 max.
• View respiratory rate.
• View body temperature.
• View blood glucose.
• View skin temperature.
• View heart/vitals metrics across day, week, month, and year ranges.
• View history charts and entry rows with value, source, and time.
• View data confidence for aggregate and raw data.
• View latest, average, lowest, highest, readings/logged days, previous-period comparison, and personal baseline where applicable.
• View blood pressure latest, average, highest, readings, previous-period comparison, and personal baseline.
• View context cards for blood pressure categories, resting heart rate, oxygen saturation, respiratory rate, and body temperature.
• Distinguish editable OpenVitals vitals entries from read-only external entries.

Mindfulness

• View mindfulness session totals and session counts for the selected period.
• View mindfulness history charts by day, week, month, and year.
• View selected-day mindfulness sessions.
• View each session's title, date/time, duration, and source.
• View data confidence.
• View daily goal progress, goal statistics, total duration, session count, average duration, longest session, previous-period comparison, and personal baseline.
• View mindfulness reminder status and reminder time.
• View cross-metric insight comparing mindfulness with sleep duration.
• Distinguish editable OpenVitals mindfulness sessions from read-only external sessions.

Cycle Tracking

• View cycle data when Health Connect permissions are granted.
• View menstruation flow entries.
• View menstruation period intervals.
• View ovulation tests.
• View cervical mucus observations.
• View basal body temperature.
• View intermenstrual bleeding.
• View sexual activity entries.
• View cycle data across day, week, month, and year ranges.
• View cycle summary cards for period days, ovulation tests, and latest basal body temperature.
• View a cycle calendar with period, ovulation test, and basal temperature markers.
• View basal body temperature trend charts.
• View observation rows with date/time, value, and source.
• View data confidence and statistics for period days, ovulation tests, basal body temperature readings, and total entries.
• View the recorded cycle day and the period start it counts from.
• View the current phase (menstrual, follicular, ovulatory transition, luteal) or the reason it cannot be placed, labelled recorded or estimated.
• View the estimated next period window, where today sits in it, and why there is no estimate yet.
• View a phase tip or a sourced cycle fact that changes daily.
• View the count, mean, and range of recorded cycles.
• View cycle history bars against a 21 to 35 day reference band, with a per-cycle detail sheet.
• View a thermal chart for the current cycle with a coverline when a temperature shift is confirmed.
• View how often each symptom was logged in each phase.
• Include a cycle section in the PDF health report: cycle-day chart, length statistics, bleeding and pain counts, a table per cycle, symptom counts, and notes.
• Export the cycle journal to a JSON file and import one back, merging by the newer edit per day.
• View today's logged observations (bleeding, pain, mood, energy, symptoms, note).
• Add a cycle home screen widget that shows the cycle day, the estimated range, and whether today is logged, with a button that hides them.

Medical Records

• View the medical records Health Connect holds, where Health Connect offers them (Android 14 and newer with a recent Health Connect module).
• Open the records home from a static dashboard tile that reads nothing.
• View twelve categories in two blocks, care and sensitive, each with its record count.
• View a declined category's records that OpenVitals added itself, with a note that other apps' records need access.
• View a category's records newest first, each with its title, date, source and status, entered-in-error included.
• View a record's main fields, its source, and its raw FHIR, with codes as words and references resolved to names.
• View lab and vital values with their unit and reference range as text, and a High or Low flag only when the lab set it.
• Records are never interpreted and nothing is computed from their values.
• Include a medical records section in the PDF health report: every allergy, condition and medication with its status, and the vaccines and lab results dated in the range, with what access kept out.

Health Connect And Sources

• View data from Health Connect-compatible sources.
• View source labels on entries where available.
• View missing-permission callouts and request relevant permissions from metric screens.
• View records imported from Apple Health once written to Health Connect.
• View records imported from a CSV file once written to Health Connect.
• View records received from another phone once written to Health Connect.

Insert / Update / Delete Data

General Rules

• Manual data changes are written to Health Connect, not to a separate OpenVitals cloud account.
• Write permissions are requested only for data types that support manual entry.
• Entries created by other apps are read-only in OpenVitals.
• OpenVitals-created entries can be edited or deleted when the app has the required Health Connect write permission.
• Some data types can be inserted through Apple Health import even when there is no manual entry screen.

Manual Entry Screen

• Open a centralized manual entry area with configurable entry widgets.
• Show entry widgets for beverages/hydration, food, activity, carbohydrate, mindfulness, cycle, weight, height, body fat, blood pressure, SpO2, respiratory rate, and body temperature.
• Reorder, remove, and manage manual entry widgets.

Beverages And Hydration

• Add beverage/hydration entries.
• Tap a container size to save a beverage entry immediately.
• Select beverage presets such as water, coffee, tea, soft drinks, energy drinks, sports drinks, oral rehydration solution, milk, fruit juice, and custom drinks.
• Save caffeine and selected nutrition defaults with supported beverages as Health Connect nutrition records.
• Select container sizes such as coffee cup, tea cup, small cup, medium glass, large glass, water bottle, and large bottle.
• Use beverage hydration multipliers for effective hydration amount.
• Manage preset/custom drink categories and ordering.
• Add custom container sizes.
• View today's intake against the daily goal while adding an entry.
• Update OpenVitals-created beverage/hydration entries.
• Delete OpenVitals-created beverage/hydration entries.
• Request Health Connect hydration and nutrition write permissions from the entry flow.

Food

• Build a food catalog: each food has a name, an amount, a category, and any of the supported nutrients.
• There are no preloaded foods; the catalog starts empty.
• Edit and delete saved foods.
• Log a portion of a saved food with an amount and a time; the nutrients scale with the amount.
• Save each logged portion directly to Health Connect as a nutrition record named after the food.
• View today's calories in while logging.
• Request Health Connect nutrition write permission from the entry flow.

Nutrition

• Add carbohydrate entries.
• Save carbohydrate totals directly to Health Connect nutrition records.
• Request Health Connect nutrition write permission from the entry flow.

Activity And Workouts

• Add workout/activity sessions manually.
• Update OpenVitals-created workout/activity sessions.
• Delete OpenVitals-created workout/activity sessions.
• Choose activity type, start date, start time, duration, distance, elevation, active calories, total calories, repetitions, title, and notes.
• Enter repetition-based workouts using total repetitions or sets with repetitions and rest minutes.
• Import route/activity files in GPX, KML, KMZ, TCX, or FIT formats.
• Import indoor and routeless activity files, which carry timing and recorded series but no positions.
• Bulk import multiple route files from Settings.
• Preview imported routes and inferred activity details before saving.
• Save imported route data with inferred type, title, notes, distance, elevation, time range, and calorie estimates where available.
• Save the heart rate, cadence, and speed series an imported file recorded, so imported activities have the same charts as recorded ones.
• Record a GPS-capable activity with GPS switched off, keeping duration, heart rate, steps, and barometric elevation.
• Run a guided heart-rate recovery test during a timed recording with a connected heart-rate sensor.
• Import PMTiles or Mapsforge map packs from Settings for offline activity maps.
• Use imported offline maps while recording activities and previewing saved or imported routes.
• Record route-based activities with GPS.
• Start, pause, resume, finish, or discard a recording.
• Save recorded route points, pause intervals, distance, and elevation.
• Use sensor-assisted repetition flows for supported activities such as treadmill steps, push-ups, pull-ups, rope skipping, and trampoline jumping.
• Request Health Connect activity write permissions from the entry flow.

Mindfulness

• Add mindfulness sessions with a timer.
• Configure timer duration.
• Configure interval bells.
• Select bell sounds: struck, rubbed, bright, temple, or harmony.
• Select background sounds: none, bowl, meditation, chimes, or dreamscape.
• Start, stop, resume, discard, and save timer sessions.
• Add manual mindfulness minutes.
• Update OpenVitals-created mindfulness sessions.
• Delete OpenVitals-created mindfulness sessions.
• Request Health Connect mindfulness write permission from the entry flow.

Cycle

• Log one day at a time: bleeding (none, spotting, light, medium, heavy), pain, mood, and energy on a 1 to 5 scale, symptoms, a private note, a pregnancy test result, basal body temperature with time and disturbance flags, cervical sensation, cervical mucus, ovulation test, and sexual activity.
• Copy yesterday's symptoms into today's log.
• Have each Health Connect record kind updated, inserted, or deleted only when its value changed.
• Keep pain, mood, energy, symptoms, notes, pregnancy test, disturbance flags, and cervical sensation in the app's local database, since Health Connect has no record type for them.
• Add a past period up to three months back so estimates start sooner.
• Exclude a cycle from estimates with an optional reason, without removing it from history.
• Delete OpenVitals-created cycle records and journal entries.
• Request Health Connect cycle write permissions from the entry flow; kinds without permission are skipped and the screen says so.

Body

• Add weight measurements.
• Add height measurements.
• Add body fat percentage measurements.
• Update OpenVitals-created weight, height, and body-fat entries.
• Delete OpenVitals-created weight, height, and body-fat entries.
• Request Health Connect body write permissions from the entry flow.
• BMI is calculated from available weight and height data and is not manually inserted.
• Lean body mass, BMR, bone mass, and body water mass are view-only in the manual UI.

Vitals

• Add blood pressure measurements with systolic and diastolic values.
• Add SpO2 measurements.
• Add respiratory rate measurements.
• Add body temperature measurements.
• Update OpenVitals-created blood pressure, SpO2, respiratory rate, and body temperature entries.
• Delete OpenVitals-created blood pressure, SpO2, respiratory rate, and body temperature entries.
• Request Health Connect vitals write permissions from the entry flow.
• Average heart rate, resting heart rate, HRV, VO2 max, blood glucose, and skin temperature are view-only in the manual UI.

Apple Health Import

• Import Apple Health export.xml or export.zip files.
• Request the Health Connect permissions needed for the selected import data.
• Track import phases including queued, parsing, writing, finishing, and complete.
• Continue import work in the background.
• Show import result summaries, unsupported records, skipped records, failures, and copy/saveable reports.
• Deduplicate imported records using stable client record IDs.
• Insert supported Apple Health activity records including steps, distance, active calories, basal energy/BMR, floors, elevation, wheelchair pushes, and workouts.
• Insert supported Apple Health heart and vitals records including heart rate, resting heart rate, oxygen saturation, respiratory rate, body temperature, blood glucose, VO2 max, and blood pressure.
• Insert supported Apple Health body records including weight, height, body fat, lean body mass, bone mass, and body water mass.
• Insert supported Apple Health hydration records.
• Insert supported Apple Health sleep records and stages.
• Insert supported Apple Health mindfulness sessions.
• Insert supported Apple Health nutrition records grouped into Health Connect nutrition records.
• Insert supported Apple Health cycle records when Health Connect write permissions are granted.
• Skip HRV SDNN import because the current Health Connect mapping is incompatible with that Apple Health record type.
• No rollback/delete flow is provided for an Apple Health import after records are written.

CSV Import

• Import body measurements and vitals from a CSV file through a five-step wizard: choose a file, map the columns, confirm, import, read the result.
• Choose the column separator and whether the first row holds column names, both detected and both overridable.
• Map each column to nothing, to the date and time, or to one of the supported measurements.
• Import weight, body fat, lean body mass, bone mass, body water, height, basal metabolic rate, heart rate, resting heart rate, heart rate variability, blood oxygen, respiratory rate, body temperature, basal body temperature, blood glucose, VO2 max, and blood pressure.
• Import blood pressure from a systolic and a diastolic column, with optional body position and cuff location columns read as the app's own words in its language or in English. Choose a default position and cuff location, remembered between imports, for a file without them or a word not recognised; the mapping lists the accepted words and names the sampled values it does not know.
• Choose the unit of each column, which describes the file rather than the app's display unit system.
• Read a body-fat column given as a mass, converting it to a percentage using the weight in the same row.
• Choose the date format, or detect it from the data, and pick which of day-first and month-first the file uses when both fit.
• Choose how a timestamp without an offset is interpreted: this phone's time zone, UTC, or a fixed offset. A timestamp that states its own offset is used as written.
• Reject a row for an unusable timestamp or too few columns, and reject a single value for an unusable number or an implausible value, keeping the rest of the row.
• Read the result as written, already present, and rejected counts, with rejections grouped by reason.
• Copy or save the import report: the parsing settings and the column mapping actually used, and each rejected row's number, column and reason, with the shape of a cell that could not be read and never its text.
• Interval records such as sleep and workouts are deliberately not supported.
• Re-importing writes no duplicates; a corrected value replaces the record at the same instant.
• No rollback/delete flow is provided for a CSV import after records are written.

Sync With Another Phone

• Copy Health Connect records between two nearby phones over Bluetooth, with no account and no network.
• Choose whether this phone is the host or the guest.
• Compare a six-digit code shown on both phones before any health data moves. The records then travel encrypted between the two phones.
• Choose how far back to sync: 30 days, 6 months, a year, or everything.
• Choose which data categories to sync from those both phones support. The cycle category also carries the cycle journal, excluded cycles, and the declared contexts and age band.
• Exchange records in both directions in a single session.
• Read a report of what was merged, what was already present, and a per-record-type breakdown, and copy or share it.
• Re-running a sync writes no duplicates.

Medical Records

• Ask for all thirteen medical permissions once, the first time the area opens, in a request that holds no other permission.
• Re-ask from the records home for what is missing, leaving out permissions Health Connect no longer asks for; when none are left, open Health Connect's settings instead.
• Import a FHIR file (one resource, a Bundle, or NDJSON) or an Apple Health export's clinical records through a five-step wizard: pick, review, confirm, import, result.
• Review each source's counts before anything is written, with unsupported types and records that would be refused listed.
• Stop until the user confirms when the file names someone other than the person already in Health Connect.
• Repair files without ids, with contained records, or with links between entries, and list each repair in the report.
• Re-importing the same file updates the same records; sources another app holds start left out.
• Copy or save the import report: counts, record types and reasons, none of the records' content.
• Export everything, one category, or one record as one FHIR Bundle that keeps each record's source, then share or save it.
• Add a vaccine, an allergy, a medication or a condition by hand, from the records home or the matching category, with free-text names and an optional code.
• Write the owner's Patient record once, with the first entry: from a Patient record the app can read, or from a name typed once.
• Edit a record typed in, keeping any fields the form does not show.
• Keep a copy of the imported file on the phone, chosen per import and off by default; an Apple Health export keeps only its clinical records, packed as one zip.
• List saved documents with their date, size and record count, and open, save, share or delete each; deleting a file keeps its records.
• Open the original document from a record that came from a kept file.
• Delete a record OpenVitals added, after a confirmation.
• Delete a source OpenVitals added and all its records, after a confirmation that names the record count.
• Records other apps added are read-only; a button opens Health Connect's data screens.

View-Only Or External-Only Data

• Sleep sessions are view-only in the app.
• Nutrition records other than logged foods, drinks, and manual carbohydrate totals are view-only in the manual UI.
• Cycle records written by other apps are view-only; only OpenVitals' own records and the local journal are editable.
• Heart rate, resting heart rate, HRV, VO2 max, blood glucose, and skin temperature are view-only in the manual UI.
• Lean body mass, BMR, bone mass, body water mass, and BMI are view-only in the manual UI.
• Planned workouts are view-only.
• Achievements are computed from activity data and are not manually edited.

Settings

Display Settings

• Change language: system default, English, Spanish, German, or Italian.
• Change unit system: metric or imperial.
• Change theme: system, light, dark, or AMOLED, with optional dynamic color.
• Change chart aggregation: raw samples, or an average line with a min/max band per time bucket.
• Change rolling dates mode: calendar week/month/year or rolling 7/30/365-day windows.

Activity Settings

• Choose the favorite/default activity behavior used by activity entry.
• Use the latest activity or a route-capable default activity type as the favorite activity source.
• Take a workout's distance from its GPS route instead of the distance records, off by default. Pace and speed follow; workouts without a readable route keep their recorded distance.

Calories Settings

• Choose calorie data mode.
• Use Health Connect calorie totals only.
• Or allow OpenVitals to calculate total calories from active calories plus BMR when Health Connect totals are missing.

Nutrition Settings

• Choose what a nutrition daily average divides by.
• Average over the days food was logged, leaving blank days out.
• Or average over every elapsed day of the week, month or year.

Sleep And Recovery Settings

• Set the evening hour a night starts and the morning hour it ends. Sleep outside that window counts as a daytime nap.
• Set the high heart-rate alert threshold in beats per minute.
• Set the low heart-rate alert threshold in beats per minute.
• Adjust Body Energy calibration and reset it to automatic.

Body Profile Settings

• Set birth year.
• Set weight, in the selected unit system.
• Set height.
• Set resting heart rate and maximum heart rate, which define the heart zones when manual zones are off.
• See when weight or height comes from a recorded measurement rather than a typed value.
• Have a changed weight or height saved as a real body measurement, so one number serves BMI, FFMI context, Body Energy, and caffeine estimates.
• Set the metabolism factors that change how quickly caffeine is cleared. All are optional, and leaving them alone uses population averages.

Cycle Tracking Settings

• Request cycle tracking permissions from the cycle settings area.
• View cycle data access alongside other Health Connect permissions.
• Declare tracking contexts: PMS, PMDD, and endometriosis add symptom suggestions; PCOS, perimenopause, and thyroid widen the estimate.
• Set an optional age band that picks the estimate's variability prior.
• Turn on local cycle reminders: a daily check-in, an upcoming-window reminder with a lead of 1 to 3 days, and a late-cycle reminder with a grace of 0 to 7 days.
• Choose what a cycle reminder shows: concealed, descriptive, or a custom title and message.

Data Import Settings

• Open Apple Health import.
• Grant import permissions.
• Select Apple Health export files.
• Import one GPX, KML, KMZ, TCX, or FIT activity file for review before saving.
• Bulk import multiple route files directly into Health Connect.
• Open the CSV importer and map a CSV file's columns to body measurements and vitals.
• Monitor import progress and read import reports.

Sync With Another Phone Settings

• Open the phone-to-phone sync wizard.
• Choose the host or guest role, the time range, and the data categories to sync.
• Copy or share the sync report.

Permission Settings

• View Health Connect permission categories.
• Grant missing requestable permissions from inside the app.
• Open Health Connect when permissions must be granted manually.
• See the all-requestable-permissions-granted state.
• Turn the Health Connect sync switch on or off.
• Turn mindfulness integration on or off, where the device's Health Connect version supports it.

Dashboard And Manual Entry Customization

• Configure dashboard widget order and visibility.
• Configure manual entry widget order and visibility.
• Restore or maintain the default widget sets through stored preferences.

Goals And Reminders

• Configure daily goals for supported metrics, including hydration, activity metrics, workout minutes, sleep, nutrition metrics, and mindfulness.
• Configure hydration reminders, reminder interval, and active reminder window.
• Configure the daily hydration goal with a stepper.
• Configure caffeine sensitivity, daily limit, and bedtime guidance.
• Configure mindfulness reminders and reminder time.
• Configure cycle reminders: daily check-in time, upcoming-window lead, late-cycle grace, and notification visibility.
• Store custom hydration container sizes.
• Log a drink with one tap from a hydration reminder notification, using recently used container sizes.
• Have reminder schedules restored after a reboot, an app update, a time zone change, or a clock change.

Privacy And App Information

• View privacy notes explaining that OpenVitals uses no account, no cloud sync, no analytics, and no ads.
• View that health data is read from and written to Health Connect on device, apart from the cycle journal, which Health Connect has no record type for and which stays in the app's local database.
• View the read-only dashboard/privacy positioning and health disclaimer.
• View app version information.
• The app declares no internet permission. Live BLE sensors and phone-to-phone sync run over Bluetooth.
• In diagnostics builds, save or share the app's logs, with addresses, identifiers, file locations, dates and error details masked, post a test hydration reminder, and list the apps that contributed heart-rate and sleep records over the last seven days.

---

Generated from Features.md. Edit it there; changes made here are overwritten.