dashboard-ui/

Dashboard UI

Go BFF (Backend-for-Frontend) + React SPA for the Nuon platform.

Architecture

server/     Go BFF (Gin + Uber fx) — serves the SPA, proxies /v1/* to ctl-api, injects runtime config
client/     React SPA (React Router v7, TanStack Query, Tailwind CSS v4, ESBuild)
public/     Static assets (served by the Go server)

The Go server validates auth cookies, rewrites them into Authorization headers for the ctl-api proxy, and injects window.__NUON_CONFIG__ into the HTML at serve time.

Development

The Go server is started separately via nctl. Then run the SPA dev server:

npm run dev

This watches client/ for changes, rebuilds JS/CSS into dist/, and proxies through BrowserSync.

Build

npm run build

Produces minified JS and CSS in dist/.

Other scripts

E2E tests

Playwright smoke tests that run against a live local (or staging) environment. Chromium only.

Prerequisites

• Local dev stack running (dashboard-ui + ctl-api + postgres + temporal)
• An admin account email with access to the admin API
• Playwright browsers installed: npx playwright install chromium

Running

# Creates a fresh test org, runs tests, deletes org on teardown
E2E_EMAIL=you@nuon.co npm run test:e2e

# Use an existing org (skips create/teardown)
E2E_EMAIL=you@nuon.co E2E_ORG_ID=orgXXX npm run test:e2e

Environment variables

How it works

1. Global setup generates a static token via the admin API
2. If no E2E_ORG_ID is set, creates a fresh org via the public API (the token user becomes org admin)
3. Injects the token as the X-Nuon-Auth cookie and saves browser state
4. Tests run against the org
5. Global teardown deletes the org if it was created by the setup

Flow docs

e2e/flows/ contains markdown flow specs that describe test scenarios in a structured format. These serve as source-of-truth documentation — update the flow markdown and regenerate specs from it.