Glossary
A
Account dashboard. The page at glasshome.app/dashboard where you manage your Hub account, view your Pro license card, and see your member number.
Addon. A packaging of GlassHome Dash for Home Assistant OS. Installed via the HA Add-on Store. See Addon.
Area. Home Assistant’s grouping of devices/entities by room. Some widgets bind to an area instead of a single entity.
B
Breakpoint. Layout slot keyed by screen width. lg (>=1024px), md (>=768px), sm (<768px). Each dashboard stores one layout per breakpoint. See Layouts.
Bundle. Compiled JS file produced by bun widget build, one per widget, plus a registry.json.
C
Config dialog. The settings panel that opens when you tap the gear or edit affordance on a widget in edit mode. Fields are auto-generated from the widget’s Zod schema. Changes save instantly.
configVersion. Integer on a widget manifest. Incremented on breaking config changes. Drives migrations.
Cloudflared. Cloudflare’s tunnel client, launched as a child process by GlassHome to expose Dash via Remote Access. Feature currently in progress.
D
Dash. The local dashboard app (the glasshome-dash container) that runs on your hardware and connects directly to Home Assistant. This is the GlassHome UI you interact with day to day.
Dashboard. A named, individually-laid-out screen inside Dash. Multiple dashboards live side by side and are switched via the dock at the bottom. Each has its own widget set and independent layout per breakpoint.
defineWidget. SDK entry point. Wraps a manifest, optional Zod schema, and SolidJS component into a registerable widget. See Widget SDK.
Demo Mode. A simulated HA backend baked into the dashboard. Lets you evaluate GlassHome without a real HA instance. See Connecting.
Detail dialog. The overlay that opens when you long-press (500 ms) a widget in live mode. Hosts fine controls (sliders, advanced actions) that don’t fit on the tile itself.
E
Early Bird. The time-limited introductory price for Pro ($19.99, available until end of June 2026). After the offer ends, the standing price ($39.99) applies. See Pro.
Edit mode. The state Dash enters when you tap the pencil icon in the header. A faint grid overlay appears, widgets show resize grips and X buttons, and gestures shift from device control to layout editing. See Editing.
Entity. A Home Assistant primitive (light.kitchen, sensor.temp). Widgets bind to one or more entities.
H
Hub. The GlassHome cloud service at glasshome.app. Hosts the widget registry, user accounts, organizations, and tunnel provisioning. Never sees dashboard data.
HAOS. Home Assistant Operating System. Includes Supervisor and addon support.
L
License / member number. Proof of a Pro purchase. Your sequential member number is assigned once at checkout and never changes. Shown on your account dashboard.
M
Manifest. manifest.json (or inline metadata in defineWidget). Declares widget name, icon, size limits, SDK version, configVersion.
Migration. A function on a widget that transforms old saved config into the current shape when configVersion increases.
O
Organization. A shared publishing scope (@org-slug). Multiple members publish under one namespace. See Organizations.
P
Polar. The payment platform GlassHome uses for Pro checkout. Handles billing and receipt emails. See Pro → How to buy.
Pro. The one-time purchase that adds community widgets and theming (the theme editor, custom backgrounds, theme upload) to Dash. Not a subscription. See Pro.
R
Registry. Hub’s catalog of published widgets. The dashboard queries it during widget browse/install. Bundles served from cdn.glasshome.app.
S
Scope. Publishing namespace. @username (personal) or @org-slug (organization). Widget IDs look like @scope/widget-name.
SDK. @glasshome/widget-sdk. Provides defineWidget, Widget components, hooks, entity helpers, theming utilities.
SDK version. Range string in a manifest (e.g. ^0.5.0) declaring which SDK majors the widget supports. Dash rejects widgets built against an unsupported SDK.
T
Theme preset. One of the 7 named built-in themes (Midnight Glass, Sunrise Studio, Forest Zen, Lavender Dreams, Coral Reef, Monochrome Pro, Ocean Breeze). Each ships with light and dark variants. Switching presets is free; editing or uploading a custom theme requires Pro. See Themes.
Trust badge. Official (verified, installs without prompt) or Community (user-published, asks for consent). Shown on every widget in the picker.
Tunnel. A cloudflared process that will expose Dash via Cloudflare’s edge once the feature ships. Provisioned through Hub. See Remote Access.
W
Widget. A tile on a dashboard bound to one or more entities. SolidJS component + Zod config.
Widget CLI. @glasshome/widget-cli. Scaffolds, builds, validates, and publishes widgets. See Widget CLI.
WebSocket (WS). The protocol Dash uses to talk to Home Assistant. Direct, low-latency, no cloud relay.