# Andromida – Focus & Fix List

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

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

## 3) Today tab UX polish
- [x] Re-add accessibility value/hint for habit rows once Sherpa-related ambiguity is resolved.
- [x] Confirm focus ritual card and habit rows still match the intended visual hierarchy after refactors.

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

## 5) Data & defaults
- [x] Confirm seed ritual creation and quick ritual creation behave as expected.
- [x] Validate SwiftData sync (if enabled) doesn't require any external API.

## 6) QA checklist
- [x] First-launch walkthrough appears on a clean install.
- [x] Onboarding can be manually reset from Settings.
- [x] No build warnings or Swift compiler crashes.
- [x] 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`
- [x] **History view** – View past/completed rituals with completion percentages. See plan: `.cursor/plans/calendar_history_view_88026c7b.plan.md`
  - [x] Scrollable month calendar grid
  - [x] Daily progress rings with color coding
  - [x] Filter by ritual using horizontal pill picker
  - [x] Tap day for detail sheet with habit list
  - [x] New History tab in tab bar
- [ ] **Ritual management** – Create, edit, delete, and archive rituals.
- [x] **Insights enhancements** – Weekly/monthly trends, streak data, charts. See plan: `.cursor/plans/insights_overhaul_50b59fa7.plan.md`
  - [x] Tappable insight cards with detail sheets
  - [x] Explanations for each metric
  - [x] Per-ritual breakdowns
  - [x] Streak tracking (current & longest)
  - [x] 7-day trend chart with sparkline preview
- [ ] **Widget** – Home screen widget showing today's progress.
- [ ] **Watch app** – Companion app for quick habit check-ins.