ZigDash

ZigDash is a modern MQTT dashboard built specifically for Zigbee2MQTT smart
homes. Connect to your own broker and control all your Zigbee devices — lights,
shutters, switches, sensors — from a clean, customizable dashboard. No cloud
account, no middleman, no tracking. Everything runs locally on your device.

━━━━━━━━━━━━━━━━━━━━━━

CONNECT TO ANY BROKER
• Compatible with any MQTT broker — TCP, SSL, WebSocket, WSS.
• Broker discovery: auto-scan your local network to find MQTT brokers.
• Optional username/password with hardware-backed secure storage — passwords
never touch plain text.
• Live connection status with automatic exponential-backoff reconnect.
• Tailscale support: access your broker remotely over your WireGuard mesh.
• Manage multiple brokers and switch between them instantly.

━━━━━━━━━━━━━━━━━━━━━━

16 PANEL TYPES — CONTROL EVERYTHING
• Toggle — on/off switch for lights, plugs, relays.
• Button — send any MQTT payload with a single tap.
• Slider — brightness dimming or position control (0–100%).
• Cover — open, stop, close for shutters and blinds, with preset positions.
• Multi-State — cycle through custom states (e.g., low/medium/high).
• Combo — toggle + slider combined in one panel.
• Radio — pick one option from a group.
• LED Indicator — display on/off state as a colored light.
• Node Status — show device online/offline at a glance.
• Progress — visualize a numeric value as a progress bar.
• Text Input — send arbitrary text payloads.
• Text Log — display MQTT message history as a scrollable log.
• Scene — capture the current state of multiple devices, then restore it with
one tap.
• Schedule — daily open/close automation executed on your always-on hub
(Node-RED), so it keeps running even when your phone is off.
• Auto-Close Rule — turn a device off / close it N seconds after it turns on.
Edge-triggered on the hub; perfect for fans, pumps, and timed lights.
• Zigbee2MQTT Device Discovery — scan for devices on your Z2M bridge and create
panels with a single tap.

Every panel supports JSON path extraction so ZigDash works with real
Zigbee2MQTT messages out of the box. Per-panel custom topics, QoS, and retain.

━━━━━━━━━━━━━━━━━━━━━━

AUTOMATION (HUB-SIDE — NOT PHONE-DEPENDENT)
• Schedule panels publish daily open/close timers as retained MQTT config.
• Auto-Close Rule panels detect edge changes and fire delayed-off commands.
• Both are executed by your always-on hub (Node-RED on SMLIGHT, Raspberry Pi,
or any MQTT-aware device). Your phone can be dead — the automation still runs.
• Bundled Node-RED flows included in the project repository.

━━━━━━━━━━━━━━━━━━━━━━

POLISHED & PRIVATE
• Material 3 design with light, dark, and system-follow themes.
• Android 12+ Material You dynamic color — the dashboard matches your wallpaper.
• Full English and Hebrew (עברית) localization with automatic RTL layout.
• Responsive panel grid — panels can span full, half, or third width.
• Dashboard locking to prevent accidental edits.
• Backup and restore your entire setup as a portable JSON file.
• Quick broker switching.
• Scenes capture and activate groups of devices together.

━━━━━━━━━━━━━━━━━━━━━━

100% PRIVATE. NO CLOUD.
• No ads. No analytics. No account. No developer server.
• Your data lives on your device and your MQTT broker — nowhere else.
• No internet permission needed for local use.
• Open source (MIT). The code is public and auditable.

━━━━━━━━━━━━━━━━━━━━━━

WHO IS THIS FOR?
You run Zigbee2MQTT with a local MQTT broker (Mosquitto, SMLIGHT SMHUB, etc.)
and want a clean, customizable dashboard that respects your privacy. If you're
tired of cloud-dependent apps, vendor lock-in, and data collection — ZigDash is
for you.

━━━━━━━━━━━━━━━━━━━━━━

WHAT YOU NEED
• A Zigbee2MQTT setup with an MQTT broker on your local network.
• Tailscale (optional) for remote access from outside your home.
• Node-RED (optional) for hub-side automation (schedules, auto-close).