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) 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.

---

PRIORITY: Wire up existing settings

5) Haptic feedback ⚡

• Add haptic feedback on habit check-in using UIImpactFeedbackGenerator.
• Respect hapticsEnabled setting from SettingsStore.
• Add haptics to other interactions (ritual creation, onboarding completion).

6) Sound effects ⚡

• Add completion sound when habit is checked in.
• Respect soundEnabled setting from SettingsStore.
• Use Bedrock SoundManager if available, or create audio service.

7) Daily reminders (notifications) ⚡

• Request notification permission when "Daily reminders" is enabled.
• Schedule daily local notification at user-preferred time.
• Add time picker to Settings for reminder time.
• Cancel notifications when setting is disabled.
• Handle notification authorization denied state in UI.

8) Ritual pacing settings ⚡

• Use ritualLengthDays setting when creating new rituals via createQuickRitual().
• Use focusStyle setting to affect ritual recommendations or insights.
• Consider adding visual indicator of current pacing in Today view.

---

Lower priority

9) 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.

10) Data & defaults

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

---

Future features

11) History view

• Add History tab or section to view completed/past rituals.
• Show completion percentage for each past ritual arc.
• Allow viewing habits and check-in history for past rituals.

12) Ritual management

• Add ability to create custom rituals (not just quick ritual).
• Add ability to edit existing rituals (title, theme, habits).
• Add ability to delete rituals.
• Add ability to archive completed rituals.

13) Insights enhancements

• Show weekly/monthly trends.
• Show streak data (consecutive days with all habits completed).
• Add charts or visualizations for progress over time.

14) Future enhancements

• HealthKit integration – See plan: .cursor/plans/healthkit_integration_plan_ce4f933c.plan.md
• Widget – Home screen widget showing today's progress.
• Watch app – Companion app for quick habit check-ins.