workout-app

Build & Run

Prerequisites

• macOS with Xcode 15+ (iOS 17 SDK required for SwiftData).
• Homebrew + xcodegen: brew install xcodegen.

First-time setup

cd /Users/gibou/code/github/workout-app
xcodegen generate
open WorkoutApp.xcodeproj

Then in Xcode:

1. Pick an iPhone simulator (any iOS 17+).
2. Product → Run (⌘R).

The app launches into the empty journal. Type “a banana” + Done — the mock resolver will fill in calories.

Whenever you add or rename a file

xcodegen generate

Then in Xcode: File → “Revert changes” if it complains about the project file having changed externally, or just close + reopen.

Building from the CLI

xcodebuild \
  -project WorkoutApp.xcodeproj \
  -scheme WorkoutApp \
  -destination 'platform=iOS Simulator,name=iPhone 15' \
  build

Substitute the simulator name with one from xcrun simctl list devices available | grep iPhone.

Running tests

xcodebuild \
  -project WorkoutApp.xcodeproj \
  -scheme WorkoutApp \
  -destination 'platform=iOS Simulator,name=iPhone 15' \
  test

Wiring a real backend

See BACKEND_SETUP.md. TL;DR:

1. Copy WorkoutApp/Resources/Secrets.example.xcconfig → Secrets.xcconfig.
2. Fill in BACKEND_URL and BACKEND_ANON_KEY.
3. xcodegen generate.

Common issues

• “Cannot find type ‘X’ in scope” in Xcode after adding a file → run xcodegen generate again.
• SwiftData migration errors after model change → in dev only, delete the simulator app to wipe local data.
• Preview crashes → previews use PersistenceController.preview (in-memory). If a preview-only seed depends on a new field, update Services/Persistence/SeedData.swift.