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

# Run Locally

> Test your app on iOS Simulator

# Run Locally

Let's start your app and see it running!

## Start Development Server

```bash theme={null}
cd apps/mobile
npm start
```

Press `i` to open iOS Simulator.

## What You Should See

1. **Welcome Screen** - Animated intro
2. **Onboarding** - Multi-step flow
3. **Paywall** - Subscription options
4. **Main App** - Home screen

<Note>
  The paywall won't show real products until you configure subscriptions in App Store Connect.
</Note>

## Development Tips

### Hot Reload

Changes automatically refresh - no restart needed.

### Open Dev Menu

* Simulator: `Cmd + D`
* Device: Shake

### View Logs

Logs appear in your terminal.

## Testing on Physical Device

### With Expo Go

1. Install **Expo Go** from App Store
2. Scan QR code from terminal

### With Development Build

```bash theme={null}
npm run build:dev
```

Install the resulting build on your device.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Simulator doesn't open">
    Make sure Xcode is installed and opened at least once.
  </Accordion>

  <Accordion title="Module not found error">
    ```bash theme={null}
    rm -rf node_modules
    npm install
    npm start -- --clear
    ```
  </Accordion>
</AccordionGroup>

## Next Step

<Card title="Build for App Store" icon="rocket" href="/quickstart/first-build">
  Create your first production build
</Card>