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

# Quickstart

> Get Vantage running on your Android device in 15 minutes.

## Prerequisites

<AccordionGroup>
  <Accordion title="Flutter 3.x" icon="mobile">
    Install Flutter from flutter.dev. Verify with `flutter --version` — need 3.0+.
  </Accordion>

  <Accordion title="Python 3.11+" icon="code">
    The backend requires Python 3.11+. Check with `python3 --version`.
  </Accordion>

  <Accordion title="Android device" icon="mobile-screen">
    Android 10 (API 29) or higher. Enable USB debugging in Developer Options.
  </Accordion>

  <Accordion title="Supabase account" icon="database">
    Sign up at supabase.com. Free tier is sufficient.
  </Accordion>

  <Accordion title="Anthropic API key" icon="robot">
    Get one from console.anthropic.com. Used for the AI advisor.
  </Accordion>
</AccordionGroup>

***

## Step 1: Clone the repo

```bash theme={null}
git clone https://github.com/rmurarishetti/vantage.git
cd vantage
```

***

## Step 2: Set up Supabase

<Steps>
  <Step title="Create a project">
    Go to app.supabase.com → New Project. Note your **Project URL** and **anon key** from Settings → API.
  </Step>

  <Step title="Run migrations">
    ```bash theme={null}
    brew install supabase/tap/supabase
    supabase link --project-ref <your-project-ref>
    supabase db push
    ```

    This creates all tables, RLS policies, and indexes.
  </Step>

  <Step title="Enable Google OAuth (optional)">
    In Supabase → Auth → Providers → Google, add redirect URL: `com.vantagewealth.app://callback`
  </Step>
</Steps>

***

## Step 3: Configure the Flutter app

```bash theme={null}
cd vantage_wealth
cp .env.example.json .env.json
```

Edit `.env.json`:

```json theme={null}
{
  "SUPABASE_URL": "https://your-project.supabase.co",
  "SUPABASE_ANON_KEY": "your-anon-key",
  "API_BASE_URL": "http://10.0.2.2:8000"
}
```

<Note>
  Use `http://10.0.2.2:8000` for Android emulator. For a physical device, use your machine's LAN or Tailscale IP.
</Note>

```bash theme={null}
flutter pub get
```

***

## Step 4: Run the backend

```bash theme={null}
cd backend
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
# Edit .env with SUPABASE_URL, SUPABASE_SERVICE_KEY, ANTHROPIC_API_KEY
uvicorn main:app --reload --port 8000
```

Verify: `curl http://localhost:8000/health` → `{"status":"ok","version":"2.0.0"}`

***

## Step 5: Build and install

```bash theme={null}
cd vantage_wealth
flutter build apk --release --dart-define-from-file=.env.json
adb install build/app/outputs/flutter-apk/app-release.apk
```

***

## Step 6: Grant notification access

Settings → Apps → Special app access → Notification access → enable **Vantage Wealth**.

This is required for automatic transaction capture from your banking apps.

***

<CardGroup cols={2}>
  <Card title="Supported banks" icon="building-columns" href="/features/supported-banks">
    See which banking apps are supported out of the box.
  </Card>

  <Card title="Ask Vantage AI" icon="robot" href="/features/ai-advisor">
    Learn what you can ask the AI advisor.
  </Card>
</CardGroup>