fix2

docs-standalone/docs/index.md

@@ -0,0 +1,38 @@
+# Overview
+
+This documentation covers the standalone rewrite located in `nspanel-lovelace-ui/`.
+
+It is a Python backend that:
+
+- receives panel input (MQTT mode or Home Assistant API mode)
+- reads Home Assistant state through the websocket API
+- renders cards and screensaver pages
+- sends panel commands back to the device
+
+This docs set is intentionally separate from the AppDaemon docs in `docs/`.
+
+## Rewrite location
+
+- Add-on package: `nspanel-lovelace-ui/`
+- Runtime code: `nspanel-lovelace-ui/rootfs/usr/bin/mqtt-manager/`
+- Example panel config: `nspanel-lovelace-ui/rootfs/usr/bin/mqtt-manager/panels.yaml.example`
+
+## What is supported
+
+- `cardEntities`
+- `cardGrid` (auto-switches to `cardGrid2` when needed)
+- `cardQR`
+- `cardPower`
+- `cardMedia`
+- `cardThermo`
+- `cardAlarm`
+- `cardUnlock`
+- screensaver with status icons and weather forecast entities
+
+## Runtime model
+
+1. Load `panels.yaml`.
+2. Resolve MQTT and Home Assistant connection settings.
+3. Create one thread per panel.
+4. Listen for events and state changes.
+5. Re-render active pages and detail popups when relevant entities change.