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

# Setup Your Project

> Clone the repository and configure your app

# Setup Your Project

Let's configure your app with your credentials.

## Step 1: Clone & Install

```bash theme={null}
# Clone the kit
git clone <your-repo-url> my-app
cd my-app

# Go to mobile app
cd apps/mobile

# Install dependencies
npm install
```

## Step 2: Run Setup Script

```bash theme={null}
npm run setup
```

You'll be prompted for:

| Prompt                   | What to Enter                                                                        |
| ------------------------ | ------------------------------------------------------------------------------------ |
| App name                 | Name shown on home screen                                                            |
| Bundle ID                | `com.yourcompany.yourapp`                                                            |
| Supabase URL             | From Supabase dashboard                                                              |
| Supabase Publishable Key | From Supabase dashboard (`sb_publishable_...`)                                       |
| RevenueCat API Key       | iOS public app-specific key (starts with `appl_`) — use test first, production later |
| MixPanel Token           | From MixPanel settings                                                               |

## Step 3: Initialize EAS

```bash theme={null}
eas init
```

This links your project to Expo's build service.

## Step 4: Run Database Migration

In Supabase SQL Editor, run the contents of:

```
apps/mobile/supabase/migrations/00000000000000_init.sql
```

## Files Created

| File       | Purpose                     |
| ---------- | --------------------------- |
| `.env`     | Your API keys               |
| `app.json` | App name and bundle ID      |
| `eas.json` | Build environment variables |

## Next Step

<Card title="Run Locally" icon="play" href="/quickstart/run-locally">
  Start the development server and test on iOS Simulator
</Card>