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.
• Smart empty states: distinguish "no rituals" vs "no rituals for current time of day".
• Fresh install starts clean (no pre-seeded rituals).

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.
• Remove automatic seed rituals on fresh install.

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) Completed enhancements

• History view – View past/completed rituals with completion percentages.

  • 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
  • Percentage display inside progress ring
  • Comparison to weekly average badge
  • Streak context badge
  • Motivational messages

• Ritual management – Create, edit, delete, and archive rituals.

  • Model enhancements (isEnabled, isArchived, timeOfDay, iconName, category)
  • RitualStore CRUD methods (create, update, delete, enable, archive)
  • Preset library with 13 categorized presets (Health, Productivity, Mindfulness, Self-Care)
  • RitualsView toolbar menu (Create New, Browse Presets)
  • RitualEditSheet for create/edit form with icon picker
  • PresetLibrarySheet with category tabs and detail views
  • RitualDetailView action menu (Edit, Enable/Disable, Archive, Delete)
  • Destructive action confirmations with history warning
  • Today view filtering by isEnabled, isArchived, and timeOfDay
  • Custom category input (beyond preset categories)
  • Habit icon picker with 100+ icons, search, and categories
  • Flexible duration: slider (7-365 days) + quick presets + custom input
  • Drag-to-reorder habits

• Ritual detail enhancements

  • Time remaining countdown
  • Ritual-specific streak tracking
  • Milestone achievements (Day 1, Week 1, Halfway, Complete)
  • Habit performance breakdown with completion rates

• Insights enhancements – Weekly/monthly trends, streak data, charts.

  • Tappable insight cards with detail sheets
  • Explanations for each metric
  • Per-ritual breakdowns
  • Streak tracking (current & longest)
  • 7-day trend chart with sparkline preview
  • Trend indicators (up/down/stable) with week-over-week comparison
  • Contextual tips based on performance
  • Days Active breakdown showing calculation details

8) Future enhancements

• HealthKit integration – Sync habit completions (water, mindfulness, exercise) to Apple Health. 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.
• Notifications – Smart reminders based on habit completion patterns.
• Export/Import – Backup and restore ritual data.
• Statistics – Monthly/yearly summary views.