explaingit

zoft123/vectorplan

Analysis updated 2026-05-18

3JavaScriptAudience · vibe coderComplexity · 2/5LicenseSetup · easy

TLDR

A drag and drop visual editor that generates the YAML, CSS, and SVG code needed to build interactive Home Assistant floorplans.

Mindmap

mindmap
  root((VectorPlan))
    What it does
      Visual floorplan editor
      Drag and drop devices
      Auto room lighting CSS
    Features
      Live sync with Home Assistant
      Custom SVG icons
      One click code export
    Tech stack
      JavaScript
      Docker
      Node.js dev server
    Use cases
      Build a floorplan card
      Map devices visually
      Skip hand writing YAML
    Setup
      Docker compose up
      Or npm run dev

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build an interactive floorplan card for Home Assistant without writing YAML by hand.

USE CASE 2

Drag and drop lights and fans onto a floorplan image to place them visually.

USE CASE 3

Trace room outlines so lights visually illuminate the right space on the map.

USE CASE 4

Pull your real Home Assistant entity IDs in automatically using an access token.

What is it built with?

JavaScriptDockerNode.jsYAMLSVGCSS

How does it compare?

zoft123/vectorplanabhagsain/bayut-maps-ratingsabhishek-kumar09/who-is-imposter
Stars333
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-04-12
MaintenanceDormant
Setup difficultyeasymoderateeasy
Complexity2/52/53/5
Audiencevibe codergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Docker is the recommended setup path, local development mode needs Node.js 18 or higher.

Licensed under the GNU General Public License, meaning you can use and modify it but must keep derivative works open source under the same license.

In plain English

VectorPlan is a visual editor that helps Home Assistant users build interactive floorplans without hand writing the YAML, CSS, and SVG code that the custom floorplan-card normally requires. Instead, you upload a picture of your floorplan, drag your smart home devices like lights and fans onto it, trace the outlines of your rooms, and the app generates the exact code you need. A few features stand out. Tracing a room lets the app automatically build the CSS needed to visually light up that space whenever the corresponding light is turned on. You can also connect the app directly to your own Home Assistant instance using a Long Lived Access Token, which pulls in your real entity IDs instead of making you type them by hand. Custom icons are supported if you want your own visuals for devices, and a single button exports all the generated YAML, SVG, and CSS at once so you can copy it straight into your setup. The recommended way to run it is Docker: clone the repository and run docker-compose up, then open the app in your browser on localhost. If you would rather modify the code yourself, there is also a local development mode that needs Node.js version 18 or higher, installed with npm install and started with npm run dev. Once you have finished building your floorplan, you generate the code, save the SVG and CSS files into your Home Assistant www folder, and paste the generated YAML into a Custom Floorplan card on your dashboard. The project is licensed under the GNU General Public License, and the README is upfront that the project was built almost entirely with AI assisted, or vibe, coding.

Copy-paste prompts

Prompt 1
Walk me through running VectorPlan with Docker and opening it on localhost:8080.
Prompt 2
Show me how to connect VectorPlan to my Home Assistant instance using a Long-Lived Access Token.
Prompt 3
Help me generate the YAML, SVG, and CSS for a floorplan and add it as a Custom Floorplan card.
Prompt 4
Explain how to set up VectorPlan's local development server with npm for making code changes.

Frequently asked questions

What is vectorplan?

A drag and drop visual editor that generates the YAML, CSS, and SVG code needed to build interactive Home Assistant floorplans.

What language is vectorplan written in?

Mainly JavaScript. The stack also includes JavaScript, Docker, Node.js.

What license does vectorplan use?

Licensed under the GNU General Public License, meaning you can use and modify it but must keep derivative works open source under the same license.

How hard is vectorplan to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is vectorplan for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.