workout-app

Workout App

A native iOS nutrition + workout tracker, “Notes-app simple.” iOS-only, SwiftUI, SwiftData. Backend is interface-driven and wires up via a single xcconfig file when ready.

For Claude / future sessions: start at CLAUDE.md. It maps every change-type to the one folder you should open.

Quick start

brew install xcodegen          # one-time
xcodegen generate
open WorkoutApp.xcodeproj

In Xcode: pick an iPhone 17+ simulator → ⌘R.

Docs

• CLAUDE.md — repo navigation map (read first)
• docs/ARCHITECTURE.md — layers, navigation, why-SwiftData
• docs/BUILD_AND_RUN.md — Xcode + CLI workflows
• docs/BACKEND_SETUP.md — how to wire Supabase + AI Gateway
• docs/DESIGN_SYSTEM.md — visual tokens + rationale
• docs/ROADMAP.md — phased build plan from the spec
• ai_build_reference_health_workout_app.md — original product spec

Status

Phase 1 prototype:

• ✅ Today screen with food input + bottom summary card
• ✅ Menu sheet → Stats / Workouts / History / Settings
• ✅ Stats: Week/Month/Year/Range pill + Calories / Weight / Macros cards
• ✅ Workouts: empty workout + active bottom card with predicted reps/weight in accent
• ✅ SwiftData persistence (UserProfile, Food, FoodLogEntry, Exercise, WorkoutTemplate, WorkoutSession, WorkoutSet)
• ✅ Mock food resolver (offline-friendly)
• ⬜ Real backend (Supabase Edge Function + AI Gateway) — see docs/BACKEND_SETUP.md
• ⬜ HealthKit integration

Repo layout

WorkoutApp/
├── App/              entry point + DI
├── Design/           Theme + view modifiers
├── Models/           SwiftData @Model types
├── Services/         protocol seams (food resolver, persistence)
├── Features/         one folder per screen
└── Resources/        assets, xcconfig

Every folder above has its own README.md. Read those, not the whole tree.