Running the Project

Once both servers are up, the app’s landing page is served at the frontend URL:

FluxPay landing — Creator-Brand Deals, secured on-chain

Frontend (Next.js dev server)


cd frontend
npm run dev

Available at http://localhost:3000 (or 3001 if 3000 is taken).


cd backend
npm run dev

Available at http://localhost:8000 by default. Set PORT in your .env to use a different port.


# Frontend
cd frontend && npx tsc --noEmit
 
# Backend
cd backend && npm run typecheck


cd backend
node --import tsx --test tests/*.test.ts

Tests use in-memory repositories — no database setup needed. They inject mocks via createApp({ skipAuth: true }).

Once both servers are running, check the backend health:


curl http://localhost:8000/health

Expected response:


{
  "status": "ok",
  "service": "fluxpay-backend",
  "storage": "memory"
}

The storage field will show "postgres" when DATABASE_URL is configured.