Setup & Installation
iOS/Android toolchain, pods, simulators, and local build verification.
Prerequisites
| Tool | macOS | Purpose |
|---|---|---|
| Xcode 15+ | Required | iOS builds and simulator |
| Android Studio | Required | Android emulator and SDK |
| Node.js 20 LTS | Required | JS runtime |
| Watchman | Recommended | File watching |
| CocoaPods | Required | iOS native dependencies |
brew install watchman
sudo gem install cocoapods
node --versionClone and install
git clone git@github.com:company/mobile-app.git
cd mobile-app
pnpm install
cd ios && bundle install && bundle exec pod install && cd ..Environment configuration
API_URL=http://localhost:4000/api
COGNITO_USER_POOL_ID=us-east-1_xxxxx
COGNITO_CLIENT_ID=xxxxxxxx
COGNITO_DOMAIN=auth.company.comUse .env.staging and .env.production for build variants.
Run locally
# iOS simulator
pnpm ios
# Android emulator
pnpm android
# Metro bundler only
pnpm startVerify setup
- Metro bundler starts without errors.
- iOS simulator launches the app.
- Login flow completes via Cognito.
- API calls return data with Bearer token.
pnpm testpasses.