NEXGO
Multi-courier shipping and logistics platform for Indian sellers: a seller workspace (orders, courier rating and booking, shipments, NDR, wallet, COD, invoices) and a separate platform-admin workspace (sellers, KYC, couriers and rate cards, COD payouts, jobs, audit).
Repository layout
| Path | What it is |
|---|
app/, components/, lib/ | Next.js 16 (App Router, React 19) frontend. Screens marked Live* call the API; the rest still render from lib/data.js. |
backend/ | Fastify + TypeScript API and job worker, PostgreSQL migrations, seed scripts. See backend/README.md. |
compose.yml, Dockerfile, backend/Dockerfile | Docker: frontend, API, worker and one-shot migrations; local Postgres/Mailpit/MinIO under --profile local. |
.env.example | The single env file for everything. Copy to .env. |
docs/ | Plans, handoff notes, staging checklist and demo runbook (index below). |
Run locally
Requires Node 20+ and either Docker or a local PostgreSQL.
cp .env.example .env # the ONLY env file; fill in the REQUIRED secrets (see comments inside)
npm install && (cd backend && npm install && npm run migrate)
(cd backend && npm run dev) # API on :4010, second terminal: npm run worker
npm run dev # web on :3021 (the API's CORS allow-list expects this origin)
Or the whole stack in Docker (production images, throwaway Postgres + Mailpit + MinIO):
docker compose --profile local up --build # http://localhost:3021, mail at http://localhost:8025
Deploying: see docs/PRODUCTION_DEPLOYMENT.md.
Development logins are fixed in the backend (backend/src/lib/devAccounts.ts) and created at startup, only when NODE_ENV=development and DATABASE_URL points at this machine. The UI never shows or pre-fills them.
New sellers register at /signup, wait for an admin to approve them under Admin > Registrations (the decision is e-mailed), then sign in.
Checks
npm run lint && npm run build # frontend
cd backend && npm run check # API type-check
Documentation
docs/ENGINEERING_HANDOFF.md — current state, what is implemented and verified, non-negotiable rules. Read before changing backend code.docs/BACKEND_PLAN.md — phased build plan and security gates.docs/LOCAL_BACKEND_BUILD_PLAN.md — local-first execution plan for seller and admin modules.docs/AWS_BACKEND_PLAN.md — mapping of the same architecture onto AWS.docs/STAGING_CHECKLIST.md — what has been verified and what blocks staging.docs/DEMO_RUNBOOK.md — scripted owner demo.
