Using the UI

Navigation

Sidebar item	Purpose
Flowgraph	Repository + endpoint sequence canvas (default landing route #/flowgraph)
Features	Feature list and subgraph / playback
Unbridged endpoints	Endpoints without feature bridge edges
Repositories	Scan triggers and repo admin (AWS platform)

Flowgraph workflow

1. Wait for the graph to load (spinners show on repo/endpoint pickers until ready).
2. Choose a repository — only repos present in the latest scan appear.
3. Choose an endpoint — grouped by HTTP method for backend ApiEndpoint nodes, or client calls on frontend repos.
4. For frontend repos with multiple UI surfaces, pick a component (page/hook) so the diagram shows one track.
5. Click nodes or edges in the diagram to open the inspector drawer.

The canvas builds a sequence view by walking CALLS, HANDLED_BY, and related edges from the selected endpoint outward — see How Helix works.

Shareable links

When you select a repo, endpoint, feature, or inspector target, the app can add a compressed ?ui= query parameter for deep linking. Landing on / without selections keeps a clean URL; shared links restore state from ?ui=.

Scan progress (AWS)

When the UI is connected to the deployed AWS platform, the Repositories view shows live scan stage updates.

Local UI without AWS

# Terminal 1
HELIX_GRAPH_PATH="$(pwd)/scans/latest/reports/technical-graph.json" npm run dev:api

# Terminal 2
npm run dev --workspace=frontend

Vite proxies /query/* to http://localhost:8787. Scan progress requires the deployed platform.