Flow Commerce Platform

Last reviewed: 2026-02-11

Flow is a multi-tenant B2B commerce platform with admin, partner, distributor, and customer portals. It is built on Next.js App Router with Supabase and Clerk.

Documentation

Start here: docs/index.md

Tech Stack

• Next.js (App Router)
• Supabase (Postgres, Auth, Storage)
• Clerk authentication
• Tailwind CSS

Local Development

npm install
cp .env.example .env.local
npm run dev

App runs at http://localhost:3000.

Core Portals

• Admin: /app/admin
• Partner: /app/partner
• Distributor: /app/distributor
• Customer portal: /store/<slug>/portal
• Storefront: /store/<slug>

Required Environment Variables

Minimum:

• NEXT_PUBLIC_SUPABASE_URL
• NEXT_PUBLIC_SUPABASE_ANON_KEY
• SUPABASE_SERVICE_ROLE_KEY
• NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY
• CLERK_SECRET_KEY

See .env.example for the full list.

Seeding

Preferred seed scripts:

npx tsx Scripts/seeding/seed-interlinked-comprehensive.ts
npx tsx Scripts/seeding/clear-all-data.ts

Common Commands

• Build: npm run build
• Typecheck: npm run typecheck
• Unit tests: npm run test:unit
• Integration tests: npm run test:integration
• UI tests: npm run test:ui

Contributing

Follow the workflow in AGENTS.md and keep docs updated per docs/index.md.