Skip to main content

​
Overview

This page covers the native toolchain and key configuration locations for the mobile app. For the step-by-step run flow, see Start the Mobile App.

​
Prerequisites

  • Node.js 24+
  • pnpm
  • Expo CLI (npm install -g @expo/cli)
  • Xcode (iOS) or Android Studio
  • Optional: a physical iOS device on the same Wi‑Fi network

​
Steps

  1. Copy the example env: 
    cd apps/mobile
cp example.env .env
  2. Install dependencies: 
    pnpm install
  3. Prebuild (prompts for bundle ID): 
    pnpm prebuild
  4. Run the app: 
    pnpm ios
pnpm android

​
Key Config Locations

  • apps/mobile/app.config.ts — bundle IDs, native plugins, build settings
  • apps/mobile/features/feature-registry.tsx — feature flags and providers
  • apps/mobile/lib/env.ts — reads EXPO_PUBLIC_* values from .env

​
Next Steps