This is the Vite/React dashboard used by ocx gui in packaged installs.
Run the proxy and dashboard as two separate dev processes:
# terminal 1, repo root
bun run dev:proxy
# terminal 2, repo root
bun run dev:guiThe root proxy dev server exposes API endpoints such as /healthz, /v1/responses,
and /api/*. It serves GET / only when a packaged dashboard build exists at
gui/dist, so a fresh clone should use the Vite dev server while editing the UI.
From the repo root:
bun run build:guiThat command installs/builds this dashboard and copies the production assets into
the package layout used by ocx gui.
cd gui
bun run lint # ESLint — hard local/CI gate (`GUI lint` in CI)
bun run doctor # React Doctor vs origin/main (changed-scope, advisory)
bun run doctor:full # Full-project React Doctor scanFrom the repo root:
bun run doctor:gui # same as gui doctor
bun run doctor:gui:full
bun run setup:hooks # pre-push runs doctor when gui/ changed| Tool | Role |
|---|---|
ESLint (bun run lint) |
Hard gate in CI and expected before merge |
React Doctor (bun run doctor) |
Advisory React health check pinned to react-doctor 0.7.8. Pre-push runs it only if gui/ changed and never blocks the push. The CI workflow reports to the step log only |
Fix ESLint errors first. Use doctor / doctor:full for deeper React triage.