Feature
Onboarding
Onboarding is Diorama's guided first-run flow from welcome through consent, permissions, import, and handoff into the app. It sets legal context, initializes health access, starts historical trend context when available, and can hand training users into a starter plan.
Why it matters
Onboarding explains each permission before requesting it and moves from setup into a usable home screen. When a starter plan is available, it also gives the training features a concrete first step.
How Diorama uses this
Move through Welcome, Consent, HealthKit permissions, import, and celebration steps. Review legal terms and grant consent before completing onboarding. Import up to a year of historical data, review the starter plan when present, and continue into the main app shell.
What you can do
Onboarding walks you through Diorama's foundation setup in a fixed sequence: welcome context, legal consent, health permissions, optional historical import, and a completion handoff.
The flow supports retry and continue behavior for permission states, and it includes analytics instrumentation for core onboarding events.
Import can pull extended history to give your trends a stronger starting baseline, reducing empty-state friction in early use.
For training users, onboarding should eventually explain why structured sessions matter: a run, ride, or swim can become a watch-guided Apple Workout instead of staying as text on the phone. That message is strongest after the user sees a concrete starter session.
Notes and limitations
The current celebration step is motivational but not yet truly personalized by best-performing metric.
Permission denial handling works, though richer guidance and direct recovery actions remain a roadmap priority.
Limitations
Trend celebration still uses a placeholder metric narrative instead of personalized strongest-signal selection. Permission-denied recovery flows are functional but not yet deeply guided. Apple Workout scheduling is a post-onboarding Plan detail action rather than a first-run permission step today. Post-onboarding guidance layers are still limited after initial completion.
Diorama
Put the week in context.
Diorama uses training, recovery, and health context to help you choose what comes next.