# home-assistant/frontend architecture

> Architecture diagram of the GitHub repository home-assistant/frontend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/home-assistant/frontend
- Repository: https://github.com/home-assistant/frontend

## Overview

Home Assistant Frontend is the browser UI for Home Assistant: users configure and monitor their home, navigate panels, and use features such as voice assistance and maps. The graph highlights the voice-assistant workflow as a concrete user-to-result path, alongside routing, reusable UI/form building blocks, and mapping. Edges follow explicit imports and calls in the supplied excerpts or SOURCE INDEX; unsampled capabilities are represented only where the tree supports a clear subsystem, and no relationship is inferred merely from co-location.

Main entry points: [`src/dialogs/voice-assistant-setup/voice-assistant-setup-step-pipeline.ts`](https://github.com/home-assistant/frontend/blob/dev/src/dialogs/voice-assistant-setup/voice-assistant-setup-step-pipeline.ts) (Assistant setup), [`src/common/map/engines/maplibre-map-engine.ts`](https://github.com/home-assistant/frontend/blob/dev/src/common/map/engines/maplibre-map-engine.ts) (MapLibre engine), [`src/panels/config/voice-assistants/dialog-voice-assistant-pipeline-detail.ts`](https://github.com/home-assistant/frontend/blob/dev/src/panels/config/voice-assistants/dialog-voice-assistant-pipeline-detail.ts) (Pipeline configuration), [`src/data/assist_pipeline.ts`](https://github.com/home-assistant/frontend/blob/dev/src/data/assist_pipeline.ts) (Pipeline data API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application UI"]
  node_router["Panel routing"]
  node_query["URL state"]
end

subgraph group_voice["Voice Assist"]
  node_assistant_setup["Assistant setup"]
  node_pipeline_picker["Pipeline picker"]
  node_pipeline_config["Pipeline configuration"]
  node_pipeline_api["Pipeline data API<br/>[assist_pipeline.ts]"]
  node_conversation_api["Conversation data<br/>[conversation.ts]"]
  node_cloud_api["Cloud status<br/>[cloud.ts]"]
  node_pipeline_debug["Pipeline run debugger"]
end

subgraph group_shared["Shared UI"]
  node_form["Schema forms<br/>[ha-form.ts]"]
  node_selector["Selector context<br/>[selector.ts]"]
  node_dialog_manager["Dialog manager"]
  node_alert["Alert component<br/>[ha-alert.ts]"]
  node_button["Button component<br/>[ha-button.ts]"]
  node_icon_button["Icon button<br/>[ha-icon-button.ts]"]
end

subgraph group_maps["Mapping"]
  node_map_engine["MapLibre engine"]
  node_map_style["Map styles<br/>[map-styles.ts]"]
  node_map_base["Base map layer<br/>[base-layer.ts]"]
  node_map_tiles["Map tile data<br/>[map_tiles.ts]"]
end

node_user(("Home Assistant user"))
node_backend(("Home Assistant backend"))

node_user -.->|"opens panels"| node_router
node_router -.->|"reads URL state"| node_query
node_user -.->|"configures assistant"| node_assistant_setup
node_assistant_setup -->|"loads agents"| node_conversation_api
node_assistant_setup -->|"checks subscription"| node_cloud_api
node_assistant_setup -->|"fetches status"| node_backend
node_assistant_setup -.->|"configures pipeline"| node_pipeline_config
node_pipeline_picker -->|"lists pipelines"| node_pipeline_api
node_pipeline_config -->|"loads languages"| node_pipeline_api
node_pipeline_config -.->|"saves pipeline"| node_backend
node_pipeline_debug -->|"renders run data"| node_pipeline_api
node_pipeline_debug -.->|"shows run result"| node_user
node_form -->|"resolves selectors"| node_selector
node_icon_button -->|"extends button"| node_button
node_map_engine -->|"loads style"| node_map_base
node_map_engine -->|"uses tiles"| node_map_tiles
node_map_engine -->|"applies styles"| node_map_style

click node_router "https://github.com/home-assistant/frontend/blob/dev/src/layouts/hass-router-page.ts"
click node_query "https://github.com/home-assistant/frontend/blob/dev/src/common/controllers/query-params-controller.ts"
click node_assistant_setup "https://github.com/home-assistant/frontend/blob/dev/src/dialogs/voice-assistant-setup/voice-assistant-setup-step-pipeline.ts"
click node_pipeline_picker "https://github.com/home-assistant/frontend/blob/dev/src/components/ha-assist-pipeline-picker.ts"
click node_pipeline_config "https://github.com/home-assistant/frontend/blob/dev/src/panels/config/voice-assistants/dialog-voice-assistant-pipeline-detail.ts"
click node_pipeline_api "https://github.com/home-assistant/frontend/blob/dev/src/data/assist_pipeline.ts"
click node_conversation_api "https://github.com/home-assistant/frontend/blob/dev/src/data/conversation.ts"
click node_cloud_api "https://github.com/home-assistant/frontend/blob/dev/src/data/cloud.ts"
click node_pipeline_debug "https://github.com/home-assistant/frontend/blob/dev/src/panels/config/voice-assistants/debug/assist-render-pipeline-run.ts"
click node_form "https://github.com/home-assistant/frontend/blob/dev/src/components/ha-form/ha-form.ts"
click node_selector "https://github.com/home-assistant/frontend/blob/dev/src/data/selector.ts"
click node_dialog_manager "https://github.com/home-assistant/frontend/blob/dev/src/dialogs/make-dialog-manager.ts"
click node_alert "https://github.com/home-assistant/frontend/blob/dev/src/components/ha-alert.ts"
click node_button "https://github.com/home-assistant/frontend/blob/dev/src/components/ha-button.ts"
click node_icon_button "https://github.com/home-assistant/frontend/blob/dev/src/components/ha-icon-button.ts"
click node_map_engine "https://github.com/home-assistant/frontend/blob/dev/src/common/map/engines/maplibre-map-engine.ts"
click node_map_style "https://github.com/home-assistant/frontend/blob/dev/src/common/map/map-styles.ts"
click node_map_base "https://github.com/home-assistant/frontend/blob/dev/src/common/map/base-layer.ts"
click node_map_tiles "https://github.com/home-assistant/frontend/blob/dev/src/data/map_tiles.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_router,node_query,node_user toneBlue
class node_assistant_setup,node_pipeline_picker,node_pipeline_config,node_pipeline_api,node_conversation_api,node_cloud_api,node_pipeline_debug toneAmber
class node_form,node_selector,node_dialog_manager,node_alert,node_button,node_icon_button toneMint
class node_map_engine,node_map_style,node_map_base,node_map_tiles toneRose
class node_backend toneIndigo
```

## Components

### Application UI

- [Panel routing](https://github.com/home-assistant/frontend/blob/dev/src/layouts/hass-router-page.ts): `src/layouts/hass-router-page.ts`
- [URL state](https://github.com/home-assistant/frontend/blob/dev/src/common/controllers/query-params-controller.ts): `src/common/controllers/query-params-controller.ts`

### Voice Assist

- [Assistant setup](https://github.com/home-assistant/frontend/blob/dev/src/dialogs/voice-assistant-setup/voice-assistant-setup-step-pipeline.ts): `src/dialogs/voice-assistant-setup/voice-assistant-setup-step-pipeline.ts`
- [Pipeline picker](https://github.com/home-assistant/frontend/blob/dev/src/components/ha-assist-pipeline-picker.ts): `src/components/ha-assist-pipeline-picker.ts`
- [Pipeline configuration](https://github.com/home-assistant/frontend/blob/dev/src/panels/config/voice-assistants/dialog-voice-assistant-pipeline-detail.ts): `src/panels/config/voice-assistants/dialog-voice-assistant-pipeline-detail.ts`
- [Pipeline data API](https://github.com/home-assistant/frontend/blob/dev/src/data/assist_pipeline.ts): `src/data/assist_pipeline.ts`
- [Conversation data](https://github.com/home-assistant/frontend/blob/dev/src/data/conversation.ts): `src/data/conversation.ts`
- [Cloud status](https://github.com/home-assistant/frontend/blob/dev/src/data/cloud.ts): `src/data/cloud.ts`
- [Pipeline run debugger](https://github.com/home-assistant/frontend/blob/dev/src/panels/config/voice-assistants/debug/assist-render-pipeline-run.ts): `src/panels/config/voice-assistants/debug/assist-render-pipeline-run.ts`

### Shared UI

- [Schema forms](https://github.com/home-assistant/frontend/blob/dev/src/components/ha-form/ha-form.ts): `src/components/ha-form/ha-form.ts`
- [Selector context](https://github.com/home-assistant/frontend/blob/dev/src/data/selector.ts): `src/data/selector.ts`
- [Dialog manager](https://github.com/home-assistant/frontend/blob/dev/src/dialogs/make-dialog-manager.ts): `src/dialogs/make-dialog-manager.ts`
- [Alert component](https://github.com/home-assistant/frontend/blob/dev/src/components/ha-alert.ts): `src/components/ha-alert.ts`
- [Button component](https://github.com/home-assistant/frontend/blob/dev/src/components/ha-button.ts): `src/components/ha-button.ts`
- [Icon button](https://github.com/home-assistant/frontend/blob/dev/src/components/ha-icon-button.ts): `src/components/ha-icon-button.ts`

### Mapping

- [MapLibre engine](https://github.com/home-assistant/frontend/blob/dev/src/common/map/engines/maplibre-map-engine.ts): `src/common/map/engines/maplibre-map-engine.ts`
- [Map styles](https://github.com/home-assistant/frontend/blob/dev/src/common/map/map-styles.ts): `src/common/map/map-styles.ts`
- [Base map layer](https://github.com/home-assistant/frontend/blob/dev/src/common/map/base-layer.ts): `src/common/map/base-layer.ts`
- [Map tile data](https://github.com/home-assistant/frontend/blob/dev/src/data/map_tiles.ts): `src/data/map_tiles.ts`

### Other components

- **Home Assistant user**
- **Home Assistant backend**

## Connections

- Home Assistant user → Panel routing: opens panels (evidence: `README.md`)
- Panel routing → URL state: reads URL state
- Home Assistant user → Assistant setup: configures assistant
- Assistant setup → Conversation data: loads agents (evidence: `src/dialogs/voice-assistant-setup/voice-assistant-setup-step-pipeline.ts`)
- Assistant setup → Cloud status: checks subscription (evidence: `src/dialogs/voice-assistant-setup/voice-assistant-setup-step-pipeline.ts`)
- Assistant setup → Home Assistant backend: fetches status (evidence: `src/dialogs/voice-assistant-setup/voice-assistant-setup-step-pipeline.ts`)
- Assistant setup → Pipeline configuration: configures pipeline
- Pipeline picker → Pipeline data API: lists pipelines (evidence: `src/components/ha-assist-pipeline-picker.ts`)
- Pipeline configuration → Pipeline data API: loads languages (evidence: `src/panels/config/voice-assistants/dialog-voice-assistant-pipeline-detail.ts`)
- Pipeline configuration → Home Assistant backend: saves pipeline
- Pipeline run debugger → Pipeline data API: renders run data (evidence: `src/panels/config/voice-assistants/debug/assist-render-pipeline-run.ts`)
- Pipeline run debugger → Home Assistant user: shows run result
- Schema forms → Selector context: resolves selectors (evidence: `src/components/ha-form/ha-form.ts`)
- Icon button → Button component: extends button (evidence: `src/components/ha-icon-button.ts`)
- MapLibre engine → Base map layer: loads style (evidence: `src/common/map/engines/maplibre-map-engine.ts`)
- MapLibre engine → Map tile data: uses tiles (evidence: `src/common/map/engines/maplibre-map-engine.ts`)
- MapLibre engine → Map styles: applies styles (evidence: `src/common/map/engines/maplibre-map-engine.ts`)
