---
title: "Glossary"
description: "A-Z definitions of GlassHome terminology. Quick lookup for terms used across the docs."
canonical: https://glasshome.app/docs/glossary
section: "Reference"
updated: 2026-06-09
---
# Glossary

## A

**Account dashboard.** The page at [glasshome.app/dashboard](/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](/docs/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](/docs/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](/docs/widget-migrations).

**Cloudflared.** Cloudflare's tunnel client, launched as a child process by GlassHome to expose Dash via [Remote Access](/docs/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](/docs/widget-sdk).

**Demo Mode.** A simulated HA backend baked into the dashboard. Lets you evaluate GlassHome without a real HA instance. See [Connecting](/docs/connecting#connection-methods).

**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](/docs/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](/docs/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](/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](/docs/organizations).

## P

**Polar.** The payment platform GlassHome uses for Pro checkout. Handles billing and receipt emails. See [Pro → How to buy](/docs/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](/docs/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](/docs/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](/docs/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](/docs/widget-cli).

**WebSocket (WS).** The protocol Dash uses to talk to Home Assistant. Direct, low-latency, no cloud relay.