Andromida/TODO.md

Andromida – Focus & Fix List

1) Onboarding walkthrough (Sherpa)

• Restore Sherpa tags for focus ritual card and first habit row without triggering Swift compiler crashes.
• Confirm walkthrough starts on first launch (ensure hasCompletedOnboarding is false in @AppStorage).
• Add a debug-only "Reset Onboarding" action in Settings to clear hasCompletedOnboarding.
• Verify tags visually align with the intended UI elements on iPhone 17 Pro Max.

2) Swift compiler stability

• Identify the minimal Sherpa usage pattern that avoids the "failed to produce diagnostic" crash.
• Avoid #Preview macro ambiguity when Sherpa is imported (use #if DEBUG + PreviewProvider or remove previews for Sherpa-tagged views).
• Avoid ambiguous accessibility modifier overloads when Sherpa is imported.

3) Today tab UX polish

• Re-add accessibility value/hint for habit rows once Sherpa-related ambiguity is resolved.
• Confirm focus ritual card and habit rows still match the intended visual hierarchy after refactors.

4) Settings & product readiness

• Add a paid-app placeholder (e.g., "Pro unlock" copy) without backend requirements.
• Confirm default settings and theme in Settings match Bedrock branding.
• Wire up haptics setting to habit check-in feedback.
• Wire up sound setting to habit check-in feedback.
• Wire up ritual length setting to quick ritual creation.
• Add daily reminder notification scheduling with time picker.

5) Data & defaults

• Confirm seed ritual creation and quick ritual creation behave as expected.
• Validate SwiftData sync (if enabled) doesn't require any external API.

6) QA checklist

• First-launch walkthrough appears on a clean install.
• Onboarding can be manually reset from Settings.
• No build warnings or Swift compiler crashes.
• iPhone 17 Pro Max simulator layout verified on Today, Rituals, Insights, Settings.

7) Future enhancements

• HealthKit integration – Sync habit completions (water, mindfulness, exercise) to Apple Health. See plan: .cursor/plans/healthkit_integration_plan_ce4f933c.plan.md
• History view – View past/completed rituals with completion percentages. See plan: .cursor/plans/calendar_history_view_88026c7b.plan.md
  • Scrollable month calendar grid
  • Daily progress rings with color coding
  • Filter by ritual using horizontal pill picker
  • Tap day for detail sheet with habit list
  • New History tab in tab bar
• Ritual management – Create, edit, delete, and archive rituals.
• Insights enhancements – Weekly/monthly trends, streak data, charts. See plan: .cursor/plans/insights_overhaul_50b59fa7.plan.md
  • Tappable insight cards with detail sheets
  • Explanations for each metric
  • Per-ritual breakdowns
  • Streak tracking (current & longest)
  • 7-day trend chart with sparkline preview
• Widget – Home screen widget showing today's progress.
• Watch app – Companion app for quick habit check-ins.