Sleep Tracking
Status: Current implemented behavior. Audience: Users and contributors. Implementation:
features/sleep,data/repository/SleepRepository.kt. Navigation:Screen.Sleep,Screen.SleepDetail, widgetSLEEP. 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.beverage-logging-and-caffeine.md: standalone caffeine tracking, active-caffeine context, and bedtime guidance.