Development Setup #

Prerequisites #

brew install xcodegen just xcbeautify swiftformat swiftlint

First-time setup #

Copy the env file
```
cp .env.example .env
```
Fill in your APPLE_TEAM_ID (find it at developer.apple.com → Account → Membership).
Generate the Xcode project
```
just generate
```
Run on simulator
```
just sim
```

Building on a real device #

Plug in your iPhone, then:

just device <your-device-udid>

Find your UDID:

xcrun xctrace list devices

Note: Device builds require your Apple ID to have certificate access on the team. If you're on an individual developer account, team members need to use TestFlight or Xcode directly with automatic signing.

Deploying a build #

just release

This bumps the build number, archives, and uploads to App Store Connect. Builds are automatically distributed to the Devs internal TestFlight group after processing.

Environment variables #

Variable	Description
`APPLE_TEAM_ID`	Apple Developer Team ID used for signing device builds and releases

just loads .env automatically. No shell changes needed.

Common commands #

Command	Description
`just generate`	Regenerate Xcode project from `project.yml`
`just sim`	Build + run on booted simulator (production API)
`just sim-local`	Build + run on booted simulator (local API)
`just device <udid>`	Build + install to plugged-in iPhone
`just test`	Run tests
`just format-fix`	Auto-fix formatting
`just lint-fix`	Auto-fix lint violations
`just release`	Bump build, archive, upload to App Store Connect