Homeglance

English · Русский

A modern, mobile-first dashboard for Home Assistant. No YAML, no compromise.

Homeglance (just Glance inside the app) is a PWA dashboard for Home Assistant that runs alongside the standard Lovelace UI instead of replacing it. The goal: give an ordinary user an iOS-home-screen-class experience — drag-and-drop widgets, smooth animations, glassmorphism, themes, multi-user support. No YAML, no changes to your HA config.

Features

• Drag-and-drop grid — tiles can be moved, resized and removed
• 28 widgets — lights, switches, locks, sensors, climate, media, cameras, covers, weather, person, map, calendar, energy, notes, clock, actions (scripts/scenes/webhooks), control panels, room hubs, glucose monitoring
• Multiple pages with a bottom dock bar — swipe to switch
• Multi-user — several PIN-protected profiles, each with its own layout
• PWA — installs as a native-like app on iOS, Android and desktop
• Dark / light / auto themes — follow the system
• English and Russian interface — switchable in settings
• Connects to HA over WebSocket — no changes to your HA config

Screenshots

Glance in light and dark themes — switchable in settings or following the system.

	☀️ Light	🌙 Dark
Home
Room
Weather
Music
Glucose monitoring

Installation

Four paths depending on your type of Home Assistant.

1. HA App / Add-on (for HA OS / Supervised — the easiest)

If you run Home Assistant OS or Home Assistant Supervised, this is the simplest path. HA itself starts and manages the Homeglance server.

Home Assistant 2026.2 renamed Add-ons to Apps. On older HA versions the menu is still called Settings → Add-ons → Add-on Store.

1. Settings → Apps → App store → ⋮ (three dots) → Repositories
2. Add the URL https://github.com/Ivkaiv/homeglance → Add
3. Find Homeglance → Install → Start
4. Homeglance appears in the HA sidebar — open it.

Zero-config authentication. Under HA Ingress the app connects to HA automatically via SUPERVISOR_TOKEN — there are no tokens to create by hand. WS and REST requests to HA are proxied server-side, and the token never leaves the container.

Persistent storage. Profiles, widgets and themes are kept in the /data mount, which the Supervisor preserves across restarts, updates and reinstalls of the app — on any HA Supervisor version.

More details: homeglance-addon/README.md.

2. HACS plugin (icon in the HA sidebar)

When you need it. The HACS plugin is not needed if you use the HA App (option 1) — it already adds Homeglance to the HA sidebar via Ingress. The plugin is for the case when the Homeglance server runs outside HA: on another machine on the network, in Docker (option 3), or on HA Core/Container where apps are unavailable.

The plugin itself does not start a server — it is an iframe wrapper for an already-running Homeglance. After installation, Glance appears in the HA sidebar as a native menu item.

1. In HACS → Frontend → Custom repositories → add https://github.com/Ivkaiv/homeglance, type Plugin
2. Find Homeglance → Install
3. Add to configuration.yaml:

   panel_custom:
     - name: homeglance-panel
       sidebar_title: Homeglance
       sidebar_icon: mdi:view-dashboard-variant
       url_path: homeglance
       module_url: /hacsfiles/homeglance/homeglance.js
       config:
         url: "http://homeassistant.local:3040"  # address of your Homeglance server

4. Restart HA → Homeglance appears in the sidebar

Important: the plugin requires a Homeglance server already running somewhere on the network — Docker (3) or a process on another host.

3. Docker / Docker Compose (any HA setup)

Works for HA Container, HA Core, or for running the dashboard on a separate server.

# docker-compose.yml
services:
  homeglance:
    image: ghcr.io/ivkaiv/homeglance:latest
    container_name: homeglance
    restart: unless-stopped
    ports:
      - "3040:3040"
    volumes:
      - homeglance-data:/app/data

volumes:
  homeglance-data:

Start it:

docker compose up -d

Open http://server-ip:3040, enter your HA URL and a Long-Lived Access Token, and you are done.

4. Run from source (for development)

git clone https://github.com/Ivkaiv/homeglance.git
cd homeglance
bun install
bun dev

Open http://localhost:3040.

Connecting to Home Assistant

On first launch Homeglance asks for:

1. Home Assistant URL — e.g. http://192.168.1.10:8123 or https://ha.example.com
2. Long-Lived Access Token — create one in HA Profile → Security → Long-Lived Access Tokens

The token is stored locally (on the Homeglance server in data/connection.json when server storage is used, or in the browser's localStorage otherwise).

Configuration

Everything is configured through the UI. No environment variables are required by default. If you want to override something:

Variable	Default	Description
PORT	3040	Server port
NEXT_TELEMETRY_DISABLED	1	Disable Next.js telemetry

See .env.example.

Documentation

User guides live in the docs/ directory:

• Getting started — connecting to Home Assistant, creating a token, the setup wizard
• User guide — editing the dashboard, pages, profiles, themes
• Widget reference — every built-in tile
• Custom widgets (SDK) — for developers

Tech stack

• Next.js 14 (App Router, standalone build)
• React 18 + TypeScript strict
• Tailwind CSS 4
• Framer Motion — animations
• react-grid-layout — drag/drop
• Bun — package manager and development runtime

Status

Alpha. Running in the author's home in production and under active development. Expect changes and rough edges. Bug reports and ideas are welcome via GitHub Issues.

Contributing

All contributions are welcome. Before opening a PR, please read CONTRIBUTING.md and the Code of Conduct.

To add a new widget, see docs/sdk.md.

License

MIT — the standard for the HA ecosystem.