Skip to content

TestFlight Deployment Guide

Prerequisites

  • [ ] Apple Developer Account ($99/year)
  • [ ] Xcode installed
  • [ ] App Store Connect access

Step 1: Configure App in Xcode

cd /Users/post/repos/github/nutri-e
open ios/Nutri-E/Nutri-E.xcodeproj

In Xcode: 1. Select the project in navigator 2. Under "Signing & Capabilities": - Team: Select your Apple Developer Team - Bundle Identifier: com.yourcompany.nutri-e (must be unique) - Automatically manage signing: ✓

Step 2: Set Version & Build Number

  1. In Xcode, select your target
  2. General tab:
  3. Version: 1.0.0
  4. Build: 1

Step 3: Create Archive

  1. Select target device: "Any iOS Device (arm64)"
  2. Menu: Product → Archive
  3. Wait for build to complete

Step 4: Upload to App Store Connect

  1. In Organizer window (opens after archive):
  2. Select your archive
  3. Click "Distribute App"
  4. Choose "App Store Connect"
  5. Choose "Upload"
  6. Follow prompts (use default options)

Step 5: Configure in App Store Connect

  1. Go to https://appstoreconnect.apple.com
  2. My Apps → Nutri-E
  3. TestFlight tab
  4. Wait for processing (5-10 minutes)
  5. Add internal/external testers

Step 6: Test

  • Testers receive email invitation
  • Install TestFlight app
  • Install and test Nutri-E

Common Issues

  • Signing errors: Ensure valid certificates in Keychain
  • Bundle ID conflict: Use unique identifier
  • Missing icons: Add app icons in Assets.xcassets

Build from Command Line (Alternative)

# Build archive
xcodebuild -project ios/Nutri-E/Nutri-E.xcodeproj \
  -scheme Nutri-E \
  -sdk iphoneos \
  -configuration Release \
  archive -archivePath ~/Desktop/Nutri-E.xcarchive

# Export IPA
xcodebuild -exportArchive \
  -archivePath ~/Desktop/Nutri-E.xcarchive \
  -exportOptionsPlist ios/ExportOptions.plist \
  -exportPath ~/Desktop/

# Upload with xcrun
xcrun altool --upload-app \
  -f ~/Desktop/Nutri-E.ipa \
  -u your-apple-id@example.com \
  -p app-specific-password