loop/docs/IOS.md

Loop Habit Tracker for iOS

The ios/LoopHabitTracker directory contains the SwiftUI implementation of the Loop Habit Tracker iOS application. The project is described using an XcodeGen manifest (project.yml). To generate an Xcode project:

1. Install XcodeGen (brew install xcodegen).
2. From the repository root run:

   cd ios/LoopHabitTracker
   xcodegen generate
   

3. Open the generated LoopHabitTracker.xcodeproj in Xcode and run on iOS 17+.

Feature coverage

The iOS codebase mirrors the structure of the original Android project while adopting SwiftUI patterns:

• Habit list with score rings, streak indicators and quick completion toggle.
• Habit detail screen with charts, history grid, statistics and editable notes.
• Persistence backed by JSON files (habits.json) with sample bootstrap data.
• Modular feature folders for list, detail, creation and settings flows.
• Placeholders for reminders, data export, widgets and backups to clearly mark the remaining work needed for parity with Android.
• Asset catalog entries (app icon, accent colors) are stubbed so the build succeeds; replace the placeholder icon names with real artwork before publishing to the App Store.

Roadmap placeholders

Some Android features require native iOS services and will be delivered in follow-up iterations. The UI already reserves their location:

• Reminder configuration toggles, waiting for UserNotifications integration.
• CSV/SQLite export entry points, pending share sheet wiring.
• Widget preview cards earmarked for WidgetKit.
• Backup and restore buttons in the settings screen to be connected to Files/CloudKit flows.

Each placeholder view describes the missing functionality so future contributors know exactly where to continue.