justfile

# iOS app — standard verbs (see global CLAUDE.md)

app := "Quietgram"
device_id := env_var_or_default("IOS_DEVICE_ID", "")
team_id := "467A4PRB8F"

# guard for recipes that target a physical device
_need-device:
    @test -n "{{device_id}}" || { echo "set IOS_DEVICE_ID to your device UDID — find it via \`xcrun devicectl list devices\`"; exit 1; }

# regenerate the xcodeproj from project.yml (run after editing project.yml or adding files)
gen:
    xcodegen generate

# open in Xcode for the normal edit/run loop
dev: gen
    open {{app}}.xcodeproj

# unit tests on a simulator (no signing)
test: gen
    xcodebuild -project {{app}}.xcodeproj -scheme {{app}} \
      -destination "platform=iOS Simulator,name=iPhone 17" \
      CODE_SIGNING_ALLOWED=NO test

# simulator smoke build (no signing) — CI-able correctness check
check: gen
    xcodebuild -project {{app}}.xcodeproj -scheme {{app}} \
      -destination "generic/platform=iOS Simulator" \
      CODE_SIGNING_ALLOWED=NO build

# DEBUG build + install to device: automatic signing, 7-day validity, readable logs
build: _need-device gen
    xcodebuild -project {{app}}.xcodeproj -scheme {{app}} \
      -destination "platform=iOS,id={{device_id}}" \
      -configuration Debug -allowProvisioningUpdates build
    APP=$(ls -td ~/Library/Developer/Xcode/DerivedData/{{app}}-*/Build/Products/Debug-iphoneos/{{app}}.app | head -1) && \
      xcrun devicectl device install app --device {{device_id}} "$APP"

# STABLE build + install: wildcard Ad Hoc profile, 1-year validity, no logs
deploy: _need-device gen
    xcodebuild -project {{app}}.xcodeproj -scheme {{app}} \
      -destination "platform=iOS,id={{device_id}}" \
      -configuration Release \
      CODE_SIGN_STYLE="Manual" \
      CODE_SIGN_IDENTITY="Apple Distribution" \
      PROVISIONING_PROFILE_SPECIFIER="Alexander Wildcard Ad Hoc" \
      DEVELOPMENT_TEAM={{team_id}} \
      clean build
    APP=$(ls -td ~/Library/Developer/Xcode/DerivedData/{{app}}-*/Build/Products/Release-iphoneos/{{app}}.app | head -1) && \
      xcrun devicectl device install app --device {{device_id}} "$APP"

# collect last 5m of device logs into ./logs/ (requires sudo; app must be a DEBUG install)
logs: _need-device
    mkdir -p logs
    sudo log collect --device-udid {{device_id}} --last 5m --output ./logs/{{app}}.logarchive
    log show ./logs/{{app}}.logarchive \
      --predicate 'process == "{{app}}"' \
      --style compact > ./logs/{{app}}-logs.txt
    @echo "wrote logs/{{app}}-logs.txt"