Running the Frontend
The frontend is a React 19 + Vite SPA located in demo-client/. It runs on port 3300 and talks to the backend API at port 6600.
1. Install dependencies
cd demo-client
npm install
2. Configure environment
Create a .env file in demo-client/:
cp .env.example .env
Key variables:
VITE_API_URL=http://localhost:6600
Update VITE_API_URL to point to wherever your backend is running.
3. Start the dev server
npm run start
The app will be available at http://localhost:3300.
Build for production
npm run build
Output goes to dist/. Serve it behind a reverse proxy (Nginx, Caddy, etc.) or upload to a static host.
Key pages
| Route | Description |
|---|---|
/auth/signin | Sign in |
/auth/signup | Create account |
/dashboard | Main analytics dashboard |
/account | User profile, 2FA, billing |
/accounts | Multi-account management |
/plans | Pricing and plan upgrades |
/payments | Checkout and invoices |
/api-keys | API key management |
/webhooks | Webhook configuration |
Tech stack
- React 19 with React Router 7
- MUI 7 (Material UI) — full light/dark theme
- TanStack Query for server state
- React Hook Form + Yup for forms
- Vite 6 as the build tool
- Cypress for end-to-end tests