# GlassHome > Local-first dashboard for Home Assistant. Runs on your hardware, connects to HA over WebSocket, customized in the UI (no YAML). Hub (this domain) hosts the widget registry and accounts. ## Key facts - The dashboard app and Home Assistant talk directly on your LAN. Hub is never in the data path. - Install methods: HA Add-on (HAOS), Docker Compose, standalone container. Multi-arch (amd64 + aarch64). - CPU requirements: SSE4.2 (x86) or ARMv8. Virtualized hosts often need a `host` CPU profile. - Widgets: SolidJS component + Zod config, built and published via `@glasshome/widget-cli`. - A Hub account is only required to publish widgets, manage organizations, or hold a Pro license. - Free tier: $0, connect to Home Assistant with all official widgets and 7 built-in themes, no account needed. PRO: $39.99, one-time purchase, unlocks community widgets, custom theming, and a special Discord role. Details: https://glasshome.app/pricing.md ## Docs Docs are split into three spaces: Dash (using the dashboard), Widget Dev (building widgets), Hub (accounts and API). - [Glossary](https://glasshome.app/md/glossary): A-Z definitions of GlassHome terminology. Quick lookup for terms used across the docs. ### Dash > Install, connect, and run your dashboard - [Dash / Getting Started / Quickstart](https://glasshome.app/md/dash/quickstart): Install GlassHome, connect it to Home Assistant, and add your first widget in under 5 minutes. - [Dash / Getting Started / Concepts](https://glasshome.app/md/dash/concepts): The GlassHome mental model. Dash, Hub, addon, widget. What each piece is, where it runs, and how they connect. - [Dash / Getting Started / Installation](https://glasshome.app/md/dash/installation): Install GlassHome as a Home Assistant addon, Docker Compose service, or standalone container. CPU requirements and VM gotchas covered. - [Dash / Getting Started / Connecting to Home Assistant](https://glasshome.app/md/dash/connecting): Pair GlassHome with your Home Assistant instance via OAuth. Setup wizard, demo mode, URL format pitfalls, and reconnection. - [Dash / Getting Started / How GlassHome Connects](https://glasshome.app/md/dash/how-glasshome-connects): The three connections behind your dashboard, and which one to check when something doesn't load. - [Dash / Dashboard / Widgets](https://glasshome.app/md/dash/widgets): Widget types built into Dash, configuring widgets, community widgets from Hub, and building your own. - [Dash / Dashboard / Layouts](https://glasshome.app/md/dash/layouts): Responsive grid breakpoints and managing multiple dashboards. Layouts are per breakpoint and per dashboard. - [Dash / Dashboard / Editing Your Dashboard](https://glasshome.app/md/dash/editing): Enter edit mode, add and remove widgets, move and resize tiles. Full gesture reference for live and edit mode. - [Dash / Dashboard / Themes](https://glasshome.app/md/dash/themes): 7 free theme presets with light/dark mode. The theme editor (colors, radius, backgrounds, upload) requires Pro. - [Dash / Dashboard / People & access](https://glasshome.app/md/dash/people-and-access): Give each person and each shared screen its own access. Rooms, controls, sensitive devices, dashboards, invite links, and what happens when access ends. - [Dash / Dashboard / Widget Security](https://glasshome.app/md/dash/widget-security): How GlassHome keeps third-party widgets from leaking your home data or controlling devices you did not approve. - [Dash / Deployment / Home Assistant Addon](https://glasshome.app/md/dash/addon): Install GlassHome as a Home Assistant addon. One-click setup for HAOS and Supervised users. - [Dash / Deployment / Docker Deployment](https://glasshome.app/md/dash/docker): Deploy GlassHome with Docker Compose or standalone container. Multi-arch image, amd64 and aarch64 auto-selected. - [Dash / Deployment / Remote Access](https://glasshome.app/md/dash/remote-access): Reach your Dash from outside your home with a VPN (WireGuard, Tailscale) or your own address (reverse proxy, Cloudflare Tunnel). - [Dash / Support / FAQ](https://glasshome.app/md/dash/faq): Frequently asked questions about the Dash app. Home Assistant, offline use, hardware, addon behavior, and remote access. - [Dash / Support / Troubleshooting](https://glasshome.app/md/dash/troubleshooting): Look up GlassHome errors and fixes by symptom or message. Illegal instruction, container won't start, CORS, connection drops, and more. - [Dash / Support / Bug Reports](https://glasshome.app/md/dash/bug-reports): How to report bugs in GlassHome. What to include, where to find logs, and how to help get it fixed fast. - [Dash / Reference / Changelog](https://glasshome.app/md/dash/changelog): Release history for the GlassHome dashboard, version by version. ### Widget Dev > Build, style, and publish widgets - [Widget Dev / Build Widgets / Getting Started](https://glasshome.app/md/widgets/widget-development): Build custom GlassHome widgets with SolidJS and the widget SDK. Scaffold, develop with hot-reload, validate, and publish. - [Widget Dev / Build Widgets / Capabilities & Permissions](https://glasshome.app/md/widgets/widget-capabilities): How a widget declares the Home Assistant access it needs. The capability grammar, access levels, narrowing, user consent, and host enforcement. - [Widget Dev / Build Widgets / Styling & Animation](https://glasshome.app/md/widgets/widget-styling): How widget styling works in the GlassHome SDK, covering per-widget CSS bundles, Tailwind utilities, your own CSS files, theme variables, container queries, and animation. - [Widget Dev / Build Widgets / Widget Previews](https://glasshome.app/md/widgets/widget-previews): Show people what your widget looks like before they install it. Declare examples once and Hub keeps the images up to date. - [Widget Dev / Build Widgets / Config Migrations](https://glasshome.app/md/widgets/widget-migrations): Handle breaking widget config changes across versions with configVersion and migrate functions. - [Widget Dev / SDK / Widget SDK](https://glasshome.app/md/widgets/widget-sdk): The GlassHome widget SDK API. defineWidget, Widget components, hooks, entity bindings, and theming. - [Widget Dev / SDK / Widget Config API](https://glasshome.app/md/widgets/widget-sdk/config): Declare a widget's settings form with defineConfig and field.* — field kinds, type inference, and raw schemas. - [Widget Dev / SDK / API Reference](https://glasshome.app/md/widgets/widget-api-reference): The complete public API of the GlassHome widget SDK. Every export across the main entry, /schemas, and /vite, with signatures. - [Widget Dev / SDK / Upgrading to SDK 1.0](https://glasshome.app/md/widgets/widget-sdk-1-0): What changed in widget-sdk 1.0 (shadow-root rendering, separate CSS, capability declarations, and no direct Home Assistant access) and how to migrate a widget. - [Widget Dev / SDK / SDK Changelog](https://glasshome.app/md/widgets/changelog): Notable Widget SDK releases, versioning rules, and what's coming in 2.0. - [Widget Dev / CLI & Publishing / Widget CLI](https://glasshome.app/md/widgets/widget-cli): All CLI commands for creating, building, testing, and publishing GlassHome widgets. - [Widget Dev / CLI & Publishing / Publishing Widgets](https://glasshome.app/md/widgets/widget-publishing): Publish your GlassHome widgets to Hub. Login, validate, version, select scope, and publish. - [Widget Dev / CLI & Publishing / CLI Changelog](https://glasshome.app/md/widgets/cli-changelog): Notable @glasshome/widget-cli releases and the Hub-enforced minimum version. - [Widget Dev / Support / FAQ](https://glasshome.app/md/widgets/faq): Frequently asked questions about widget development. Open source, review process, and publishing trust. - [Widget Dev / Support / Troubleshooting](https://glasshome.app/md/widgets/troubleshooting): Fixes for widget development and publishing problems. SDK version mismatches, preview rendering, and publish failures. ### Hub > Accounts, organizations, Pro, and the API - [Hub / Account / Organizations](https://glasshome.app/md/hub/organizations): Create and manage organizations on GlassHome Hub to publish widgets under a shared team scope. - [Hub / Account / Pro](https://glasshome.app/md/hub/pro): What GlassHome Pro unlocks, how the free tier compares, how to buy, and how to manage your one-time Pro license. - [Hub / API / API Reference](https://glasshome.app/md/hub/api-reference): GlassHome Hub public HTTP API. Versioned widget catalog endpoints for external integrators. - [Hub / Support / FAQ](https://glasshome.app/md/hub/faq): Frequently asked questions about Hub accounts, privacy, pricing, and Pro. - [Hub / Reference / Changelog](https://glasshome.app/md/hub/changelog): Hub platform and API change history, including API versioning and sunset policy. ## Blog - [Shipping a widget other people install](https://glasshome.app/md/blog/ship-a-glasshome-widget): Capabilities, preview images and config migrations: the three things that decide whether a stranger keeps your widget installed. - [Widgets that show data over time](https://glasshome.app/md/blog/widget-data-over-time): Reading Home Assistant history and statistics from a widget, and rendering a different tile at 2x1 than at 3x2. - [Build your first GlassHome widget](https://glasshome.app/md/blog/build-your-first-glasshome-widget): A step-by-step tutorial: build a group-aware, dimmable lights tile for GlassHome, the dashboard app for Home Assistant, from empty folder to published widget. - [The best Home Assistant dashboards in 2026](https://glasshome.app/md/blog/best-home-assistant-dashboards): Sections, Mushroom, Bubble Card, GlassHome, Magic Frame, or Tunet? A fair look at the best Home Assistant dashboard options in 2026, including where each one falls short (mine included). - [GlassHome vs the default Home Assistant dashboard](https://glasshome.app/md/blog/glasshome-vs-home-assistant-dashboard): Home Assistant's Sections view does drag-and-drop now. So why GlassHome? A comparison of polish, setup effort, wall-tablet use, and price. - [GlassHome vs Mushroom cards](https://glasshome.app/md/blog/glasshome-vs-mushroom): Mushroom gives Home Assistant beautiful cards you assemble yourself. GlassHome is a finished dashboard product. A look at which one fits you. ## How to navigate - New users: start with `/md/dash/quickstart`, then `/md/dash/concepts` for the mental model. - Operators: `/md/dash/installation`, `/md/dash/docker`, `/md/dash/addon`, `/md/dash/troubleshooting`. - Widget authors: `/md/widgets/widget-development`, then `/md/widgets/widget-sdk` and `/md/widgets/widget-cli`. - Each doc is available as plain Markdown at `/md//` (frontmatter-prefixed).