web

ARCS Web

Vite + React + TypeScript frontend for the ARCS HTTP / WebSocket API.

The UI walks the user through four configuration steps (data source, behavior, question, review), kicks off a run via POST /api/start, then streams progress over WS /ws. History is persisted to localStorage.

Develop

cd apps/web
npm install
npm run dev          # http://localhost:5173

The dev server expects the ARCS backend at http://localhost:8000. Start it separately with:

arcs serve           # from the repo root, after `pip install -e .[server]`

If your backend lives elsewhere, edit the fetch and WebSocket URLs in src/App.tsx and src/components/ProcessView.tsx.

Build

npm run build        # static bundle in apps/web/dist
npm run preview      # local preview of the production bundle

The production Dockerfile in the repo root runs npm run build in a multi-stage build and serves the bundle from the FastAPI server.

Linting

npm run lint

The flat ESLint config uses @vitejs/plugin-react and Tailwind for styling. To enable stricter type-aware rules, switch to tseslint.configs.strictTypeChecked in eslint.config.js.