> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gdilabs.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Frontend

> Next.js 16 / React 19 dashboard. Hosted on Vercel.

## Surfaces

* `/` — dashboard.
* `/workflows` — workflow editor and runner (graph + prompt composer + panels).
* `/agents` — agent activity and metrics.
* `/atlas` — 3D knowledge graph.
* `/multi` — command-centre and multi-job view.
* `/knowledge` — admin edit surface for the knowledge hub.

## What it owns

* SSE consumption of Mother AI's per-job event stream and rendering of backlog plus live events.
* Project lifecycle UI — create, list, link to workspaces.
* Workflow editor and runner.
* 3D knowledge atlas.
* Command-centre and telemetry views.

## Invariants

* The frontend is **stateless beyond local UI state**. Every long-lived resource — jobs, projects, workflows, hub edits — lives in Postgres or Qdrant via Mother AI.
* SSE is the primary live channel. The `useJobStream` hook replays the durable backlog before joining the pubsub stream so a reconnecting client never misses events.
* React-Query owns server-state caching.

## Stack

Tailwind, Radix primitives, shadcn-style components. The 3D atlas uses `@react-three/fiber`, `@react-three/drei`, and `d3-force-3d`.
