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

# Quickstart

> Get the Tonnex development environment running in 5 minutes.

# Quickstart

## Prerequisites

* **Node.js** 20+
* **pnpm** 9+
* **Docker** (for local Supabase)
* **Supabase CLI** (`brew install supabase/tap/supabase`)

## Setup

### 1. Clone & Install

```bash theme={null}
git clone https://github.com/avyra-technologies/tonnex.git
cd tonnex
pnpm install
```

### 2. Start Local Supabase

```bash theme={null}
supabase start
```

This starts a local PostgreSQL + Auth + Storage stack. Note the output — you'll need the URLs and keys.

### 3. Configure Environment

```bash theme={null}
cp .env.example .env.local
```

Fill in the values from `supabase status`:

```env theme={null}
NEXT_PUBLIC_SUPABASE_URL=http://127.0.0.1:54321
NEXT_PUBLIC_SUPABASE_ANON_KEY=<from supabase status>
SUPABASE_SERVICE_ROLE_KEY=<from supabase status>
DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:54322/postgres
```

### 4. Run Database Migrations

```bash theme={null}
pnpm db:push
```

### 5. Start Development

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

This starts all apps concurrently:

| App           | URL                                                                        |
| ------------- | -------------------------------------------------------------------------- |
| Web Dashboard | [http://localhost:3000](http://localhost:3000)                             |
| API Server    | [http://localhost:3001/api/v1/health](http://localhost:3001/api/v1/health) |
| Docs          | [http://localhost:3002](http://localhost:3002)                             |

## What's Next?

<CardGroup cols={2}>
  <Card title="Architecture" icon="sitemap" href="/architecture">
    Deep dive into the system design
  </Card>

  <Card title="Adding a Module" icon="plus" href="/guides/adding-a-module">
    Build your first feature
  </Card>
</CardGroup>