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

---

## 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
- [x] 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.