Development Setup

Prerequisites

• macOS with Xcode 15+
• XcodeGen (brew install xcodegen)
• iOS 17.0+ simulator or device

Build

cd ios
xcodegen generate
open HeartE.xcodeproj

Select an iOS 17+ simulator and press Cmd+R to build and run.

Testing

xcodebuild test -project ios/HeartE.xcodeproj -scheme HeartE \
  -destination 'platform=iOS Simulator,name=iPhone 16 Pro' \
  CODE_SIGNING_ALLOWED=NO

Project Structure

heart-e/
├── ios/
│   ├── project.yml          # XcodeGen spec
│   ├── HeartE/              # App source
│   │   ├── App/             # Entry point
│   │   ├── Models/          # SwiftData models
│   │   ├── Views/           # SwiftUI views
│   │   └── Services/        # Business logic
│   └── HeartEWidget/        # WidgetKit extension
├── docs/                    # This documentation
└── version.txt              # Release-please version

CI/CD

• Xcode Cloud — Automatic builds on push to main
• Release Please — Version management via conventional commits
• GitHub Actions — CI checks, auto-merge