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 sim-fresh`	Same as `just sim`, but uninstalls first to wipe app sandbox (URLCache, UserDefaults, on-disk caches)
`just sim-local-fresh`	Same as `just sim-local`, but uninstalls first
`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

grain.social/grain-ios Switch repository Loading…