Getting Started with HAFloorplan

1. Open the HAFloorplan editor

Choose Open Editor and work in the visual floor-plan editor. Your rooms define the floor plan, and devices are placed where you want their Home Assistant controls to appear.

2. Enter the Title and Home Assistant Entity ID

Select the Light or Power Plug on the floor plan. In the device inspector, enter a friendly Title and the exact Entity ID you identified before starting. These are the two required values for the current MVP.

The Entity ID is the critical connection to Home Assistant. HAFloorplan handles the normal Picture Elements control structure for you, so you do not need to write the Lovelace action YAML yourself.

3. Export for Home Assistant and copy the YAML

Open the editor Actions menu and choose Export for Home Assistant. HAFloorplan checks the project and opens the export screen with the generated Picture Elements configuration.

On the export screen, click Copy YAML to Clipboard. Copy the complete generated configuration; there is no need to select individual YAML sections.

4. Create a Panel view and paste the YAML in Home Assistant

In Home Assistant, edit the dashboard where you want the floor plan and create a view configured as Panel. A Panel view lets one card use the dashboard view as its primary full-width surface, which is the intended layout for this floor-plan workflow.

Add any card as a temporary starting card. Open that card's menu, choose Show code editor, replace the card configuration with the complete YAML copied from HAFloorplan, and save.

Treat the generated YAML as the complete card configuration for this MVP path. You should not need to understand or edit the generated Picture Elements structure.

5. Verify the rendered floor plan

After saving, Home Assistant should render the floor plan as a Picture Elements card. The Light or Switch appears at the location you placed it in HAFloorplan. Tap the entity control and verify that it operates the Home Assistant entity you mapped.