Skip to main content

Frontend Setup

The Nimbus frontend is a Next.js app.

Prerequisites

  • Node.js 20+
  • npm or yarn

Install

cd nimbus/frontend
npm install

Configure

Create .env.local:

NEXT_PUBLIC_API_URL=http://localhost:8000
NEXT_PUBLIC_WS_URL=ws://localhost:8000

For a remote backend:

NEXT_PUBLIC_API_URL=https://your-backend.example.com
NEXT_PUBLIC_WS_URL=wss://your-backend.example.com

Development server

npm run dev

The frontend is available at http://localhost:3000.

Build for production

npm run build
npm run start

Or export as static files:

npm run build
npm run export
# Output in ./out/

Deploy to Vercel

The frontend is configured for Vercel deployment:

vercel deploy

Set NEXT_PUBLIC_API_URL and NEXT_PUBLIC_WS_URL in your Vercel project environment variables.