Settings And Preferences
Status: Current implemented behavior. Audience: Users and contributors. Implementation:
features/settings,data/repository/PreferencesRepository.kt. Navigation:Screen.Settingsand settings subsection routes; sections inSettingsSection. Related: Feature map, Permissions, Metric detail customization.
Settings centralize app preferences, Health Connect access, imports, sensors, metric preferences, and diagnostics.
Display
Users can configure:
- Language.
- Unit system.
- Theme mode, including system, light, dark, and AMOLED.
Display preferences affect app presentation only. They do not rewrite Health Connect records.
Metric Preferences
Metric-specific settings include:
- Activity week mode, such as Monday-to-Sunday or rolling last 7 days.
- Favorite or latest activity defaults used by activity entry and recording setup.
- Nutrition settings, including calorie data mode and caffeine sensitivity, daily limit, and bedtime guidance.
- Recovery settings, including sleep range mode and Body Energy calibration.
Goals And Reminders
Settings expose local goals and reminders for supported metric families, including hydration and mindfulness reminders.
Goals and reminders are local app preferences. They help shape guidance and notifications but do not create Health Connect health records by themselves.
Health Connect
Health Connect settings show sync state, permission categories, missing access, app lock, and actions for requesting or opening Health Connect permission management.
OpenVitals asks for read permissions for dashboard and detail views. Write permissions are requested only when a user enters, imports, records, edits, or deletes data that needs them.
Data Importers And Sensors
Settings provide Data Importers for Apple Health export import and FIT activity/course/workout import, plus entry points for offline map pack import and Bluetooth LE sensor management.
Diagnostics And App Information
The settings area includes app version information, diagnostics/support surfaces, and privacy notes.