Skip to main content

​
Quickstart

​
Prerequisites

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

​
Setup

​
1. Clone & Install

git clone https://github.com/avyra-technologies/tonnex.git
cd tonnex
pnpm install

​
2. Start Local Supabase

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

​
3. Configure Environment

cp .env.example .env.local
Fill in the values from supabase status: 
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:[email protected]:54322/postgres

​
4. Run Database Migrations

pnpm db:push

​
5. Start Development

pnpm dev
This starts all apps concurrently:
AppURL
Web Dashboardhttp://localhost:3000
API Serverhttp://localhost:3001/api/v1/health
Docshttp://localhost:3002

​
What’s Next?

Architecture

Deep dive into the system design

Adding a Module

Build your first feature