Sleep Tracking

Status: Current implemented behavior. Audience: Users and contributors. Implementation: features/sleep, data/repository/SleepRepository.kt. Navigation: Screen.Sleep, Screen.SleepDetail, widget SLEEP. Related: Feature map, Sleep score and recovery, Statistics.

The sleep feature owns the main period-based sleep detail screen and individual sleep-session detail route.

What It Shows

Sleep can show:

• Sleep sessions for the selected period.
• Day summaries and period summaries.
• Sleep stage timelines where Health Connect stage data is available.
• Duration, efficiency, score, continuity, goal progress, and recovery context.
• Session lists and session details.
• Previous-period comparisons, baselines, confidence, and source labels.

Detail Pattern

Sleep follows the canonical period-detail model:

• Day, week, month, and year ranges.
• Selected anchor date.
• Previous/next navigation and calendar selection.
• Pull to refresh.
• Day-specific content when a daily summary is available.
• Week/month/year content when sessions exist in the selected period.
• Reorderable sections.

The sleep session detail route is separate from the period overview and focuses on one session's timing, stages, and source context.

Related Features

• sleep-score-and-recovery.md: sleep score, sleep efficiency, recovery details, and confidence.
• caffeine-aware-sleep-insights.md: current standalone caffeine feature and planned direct sleep integration.

---

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