Next.js 16 + Express + TypeScript + Prisma 6 + Supabase
Modern Fullstack Architecture for Orvatos
A cleanly decoupled monorepo structure with a high-performance Next.js frontend, an Express TypeScript backend, and PostgreSQL persistence powered by Prisma and Supabase.
System Diagnostics
Targeting backend: resolving...
Express API
Offline
Failed to connect
Supabase DB
Awaiting Status
Check DATABASE_URL
Next.js Client
Active
App Router • React 19
Quick Setup & Workflow
1. Connect Supabase
Paste your Supabase PostgreSQL connection string inside backend/.env
DATABASE_URL="postgresql://..."
2. Run Migration
Push your Prisma schema to Supabase to generate your database tables and client.
cd backend
npm run prisma:migrate
npm run prisma:migrate
3. Start Developing
Run both services concurrently in your terminal with hot-reloading enabled.
# Terminal 1: backend
npm run dev
# Terminal 2: frontend
npm run dev
npm run dev
# Terminal 2: frontend
npm run dev
Stack Specification
Frontend
Next.js 16 (Turbopack)
React 19, Tailwind CSS v4, Lucide
Backend
Node.js + Express (TS)
Zod validation, Helmet, CORS, TSX
Database
PostgreSQL (Supabase)
Prisma ORM 6 with schema migrations
Assets
Orvatos Brand Kit
Pre-configured SVG logos & favicons