Skip to Content
FeaturesHydration

Hydration

Status: Current implemented behavior. Audience: Users and contributors. Implementation: features/hydration, features/hydration/reminders, features/manualentry/hydration, data/repository/HydrationRepository.kt. Navigation: Screen.Metric, hydration entry routes, widget HYDRATION, ManualEntryWidgetId.HYDRATION. Related: Feature map, Beverage logging and caffeine, Reminders.

The hydration feature owns the period-based hydration detail screen and hydration reminder controls.

What It Shows

Hydration can show:

  • Daily hydration totals.
  • Period totals and trends.
  • Goal progress.
  • Previous-period comparison and baseline context.
  • Hydration entries, including entries created from beverage logging.
  • Nutrition-only hydration-related entries when they contribute useful context.
  • Data confidence and source labels.
  • Hydration reminder configuration.

Detail Pattern

Hydration follows the canonical metric detail model:

  • Day, week, month, and year ranges.
  • Selected anchor date.
  • Previous/next navigation and calendar selection.
  • Pull to refresh.
  • Reorderable detail sections.
  • Selected-day charts and entry history.

OpenVitals-created hydration entries can be edited or deleted from the relevant entry flow. External Health Connect records remain read-only.

Reminders

Hydration reminders are local notification reminders. The feature stores reminder preferences locally, checks notification permission on supported Android versions, and does not create Health Connect records when reminders fire.