iOS Device Quick Start

iOS Device Quick Start

Quick reference for running the app on a physical iPhone.

Prerequisites Checklist

• iPhone connected via USB
• iPhone unlocked and trusted on Mac
• Xcode installed and signed in with Apple ID
• Project dependencies installed (npm install)

Quick Commands

# Navigate to project
cd shaker

# List connected devices
npm run ios:list-devices

# Run on connected device (will prompt for device selection)
npm run ios:device

# Or start Metro bundler and select device from Expo Dev Tools
npm run start:ios

First Time Setup

1. Connect iPhone → Unlock → Trust computer
2. Open Xcode → ios/Bartendie.xcworkspace
3. Configure Signing:
   • Select Bartendie target
   • Signing & Capabilities tab
   • Enable “Automatically manage signing”
   • Select your Team
4. Run the app: npm run ios:device
5. Trust Developer on iPhone:
   • Settings → General → VPN & Device Management
   • Trust your Apple ID certificate

Troubleshooting

Issue	Solution
Device not detected	Check USB cable, unlock iPhone, trust computer
Build fails	Clean build: npm run clean && cd ios && pod install
Signing error	Check Xcode → Settings → Accounts, add Apple ID
App won’t launch	Trust developer certificate in iPhone Settings
Metro connection fails	Ensure same Wi-Fi network or use --tunnel

Full Documentation

See iOS Device Setup Guide for detailed instructions.