Repository navigation
[Feature] Compact Today navigation and metabolic design system #91
Description
Outcome
Establish the compact product shell and visual system for OpenGlucose's transition from a single long CGM dashboard into a coherent metabolic-context product.
Product structure
Top-level navigation:
- Today — current glucose, one body timeline, compact context, one evidence-backed observation, quick add.
- Timeline — chronological meals, workouts, sleep, notes, and glucose context.
- Trends — qualified comparisons, weekly recap, and long-term profile.
- Settings remains a secondary destination, not a primary tab.
Scope
- Centralize color, typography, spacing, shape, chart, semantic-state, and motion tokens.
- Add light/dark themes and reusable compact card/chip/rail components.
- Introduce navigation and route ownership without changing feature semantics.
- Build responsive Today shell slots for hero, timeline, context chips, observation, compact metric strip, and quick add.
- Preserve all current CGM states: no sensor, retained history, connecting, warmup, live, expired, and sample.
- Define skeleton, empty, error, denied/no-accessible-data, and stale states.
Parallelization
Ready now, independent of #89's database implementation.
This issue owns navigation, theme, and shared shell files. Other dashboard/chart features must not edit those files concurrently. Land this scaffolding before the unified body-timeline issue.
Acceptance criteria
- Today, Timeline, and Trends routes exist with stable navigation and deep-link-safe state restoration.
- Centralized design tokens replace feature-local hard-coded visual decisions in migrated surfaces.
- Current sensor states render truthfully without cached/sample data appearing live.
- Layout is clean at 375, 390, and 430 point widths.
- 200% text, VoiceOver/TalkBack traversal, contrast, reduced motion, and dark mode are verified.
- Existing CGM flows and widget tests remain green.
- Rendered screenshots cover empty, warmup, live, stale, retained-history, and sample states.
- R2 UI/accessibility review evidence is attached.
Out of scope
- Health imports.
- Journal persistence.
- Final overlay chart implementation.
- AI generation.
Coordination
Serialize changes touching openhealth/lib/main.dart, dashboard shell widgets, navigation, theme ownership, and chart container contracts.
Repository-owner recreation of the legacy issue at #38. The original discussion remains available there.
Activity