> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launchtoday.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Environment Setup

> Complete guide to setting up your development environment for the mobile app

## 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](/getting-started/run-mobile).

## 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:

   ```bash theme={null}
   cd apps/mobile
   cp example.env .env
   ```

2. Install dependencies:

   ```bash theme={null}
   pnpm install
   ```

3. Prebuild (prompts for bundle ID):

   ```bash theme={null}
   pnpm prebuild
   ```

4. Run the app:

   ```bash theme={null}
   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

* [Start the Backend](/quickstart)
* [Start the Mobile App](/getting-started/run-mobile)
* [Authentication Setup](/authentication/backend-setup)