How home-assistant/frontend works
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: voice-assistant-setup-step-pipeline.ts Assistant setup · maplibre-map-engine.ts MapLibre engine · dialog-voice-assistant-pipeline-detail.ts Pipeline configuration · assist_pipeline.ts Pipeline data API
Components 21
Application UI
- Panel routing
src/layouts/hass-router-page.ts - URL state
src/common/controllers/query-params-controller.ts
Voice Assist
- Assistant setup
src/dialogs/voice-assistant-setup/voice-assistant-setup-step-pipeline.ts - Pipeline picker
src/components/ha-assist-pipeline-picker.ts - Pipeline configuration
src/panels/config/voice-assistants/dialog-voice-assistant-pipeline-detail.ts - Pipeline data API
src/data/assist_pipeline.ts - Conversation data
src/data/conversation.ts - Cloud status
src/data/cloud.ts - Pipeline run debugger
src/panels/config/voice-assistants/debug/assist-render-pipeline-run.ts
Shared UI
- Schema forms
src/components/ha-form/ha-form.ts - Selector context
src/data/selector.ts - Dialog manager
src/dialogs/make-dialog-manager.ts - Alert component
src/components/ha-alert.ts - Button component
src/components/ha-button.ts - Icon button
src/components/ha-icon-button.ts
Mapping
- MapLibre engine
src/common/map/engines/maplibre-map-engine.ts - Map styles
src/common/map/map-styles.ts - Base map layer
src/common/map/base-layer.ts - Map tile data
src/data/map_tiles.ts
Other components
- Home Assistant user
- Home Assistant backend
Connections 17
- Home Assistant user → Panel routing: opens panels
README.md - Panel routing → URL state: reads URL state
- Home Assistant user → Assistant setup: configures assistant
- Assistant setup → Conversation data: loads agents
src/dialogs/voice-assistant-setup/voice-assistant-setup-step-pipeline.ts - Assistant setup → Cloud status: checks subscription
src/dialogs/voice-assistant-setup/voice-assistant-setup-step-pipeline.ts - Assistant setup → Home Assistant backend: fetches status
src/dialogs/voice-assistant-setup/voice-assistant-setup-step-pipeline.ts - Assistant setup → Pipeline configuration: configures pipeline
- Pipeline picker → Pipeline data API: lists pipelines
src/components/ha-assist-pipeline-picker.ts - Pipeline configuration → Pipeline data API: loads languages
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
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
src/components/ha-form/ha-form.ts - Icon button → Button component: extends button
src/components/ha-icon-button.ts - MapLibre engine → Base map layer: loads style
src/common/map/engines/maplibre-map-engine.ts - MapLibre engine → Map tile data: uses tiles
src/common/map/engines/maplibre-map-engine.ts - MapLibre engine → Map styles: applies styles
src/common/map/engines/maplibre-map-engine.ts