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

# Customizing the chat UI

> Theme, layout, and full UI replacement.

The standalone ships a Next.js UI bundled into the wheel. There are three levels of customization.

## Level 1 — Theme

Open `/admin/settings/`. Change the app name, greeting, layout (branded / minimal / inspector), color palette (light + dark), radius, font, and starter prompts. Save, and the change applies immediately to all clients.

The theme is persisted in the `theme` table alongside the rest of the admin state.

## Level 2 — Replace the chat UI entirely

The static UI is mounted from a directory. Override it via `IDUN_UI_DIR`:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
IDUN_UI_DIR=/path/to/your/built/ui idun serve
```

Your UI just needs to:

* Be a static export (HTML + JS + CSS).
* Call the standalone's REST endpoints — auth at `/admin/api/v1/auth/login`, agent run at `/agent/run`, etc.
* Optionally read `/runtime-config.js` for theme + auth mode.

The bundled UI lives in the [`services/idun_agent_standalone_ui`](https://github.com/Idun-Group/idun-agent-platform/tree/main/services/idun_agent_standalone_ui) directory; fork it.

## Level 3 — Headless

Mount no UI at all (point `IDUN_UI_DIR` at an empty directory or omit the bundled UI from your image). The admin REST surface and `/agent/run` remain available for your own frontend.

## Next steps

<Card title="CLI reference" icon="terminal" horizontal href="/cli/overview">
  Every `idun` command, the flags it accepts, and what it does.
</Card>

<Card title="Deploy to Cloud Run" icon="cloud-upload" horizontal href="/standalone/cloud-run">
  Run the standalone on Google Cloud Run with a managed container.
</Card>

<Card title="Authentication" icon="lock" horizontal href="/auth/overview">
  Configure admin-panel auth for `/admin/*`.
</Card>