diff --git a/README.md b/README.md
new file mode 100644
index 0000000..98aeacf
--- /dev/null
+++ b/README.md
@@ -0,0 +1,77 @@
+# MixItUpBot + Home Assistant Integration
+
+Dette projekt giver dig en brugervenlig HTML-dashboard frontend og en lille proxy-server, der gør det muligt at:
+
+- ✅ Styre lys og switches i Home Assistant
+- 📊 Læse status på sensorer (fx temperatur, luftfugtighed)
+- 🔍 Søge blandt enheder
+- 👥 Vælge flere enheder og udføre gruppehandlinger
+- 🌙 Dark mode for mobil og desktop
+- 🖥️ Køre sammen med MixItUpBot til brug i livestreams eller chat automation
+
+## 🛠 Krav
+
+- Python 3.8+
+- Home Assistant med Long-Lived Access Token
+- MixItUpBot (valgfrit, til brug med HTTP Requests)
+- En mappe med følgende filer:
+  - `ha_proxy.py`
+  - `templates/index.html`
+  - `mixitup_integration.yaml` (eksempel på MixItUp-kommando)
+
+## 🚀 Kom i gang
+
+1. Udpak ZIP-filen og åbn en terminal i mappen.
+2. Rediger `ha_proxy.py` og indsæt din Home Assistant token og IP/port:
+
+```python
+HA_URL = "http://192.168.X.X:8123"
+TOKEN = "din_long_lived_token"
+```
+
+3. Start serveren:
+
+```bash
+python ha_proxy.py
+```
+
+4. Åbn dashboardet i din browser:
+
+```
+http://[DIN_IP]:5001/
+```
+
+## 🔧 Funktioner
+
+- **Søg og vælg** dine lys, switches og sensorer
+- **Styr flere enheder samtidig** (tænd, sluk, toggle)
+- **Se status** på både styrbare og skrivebeskyttede enheder
+- **Responsivt UI** med mørkt tema
+
+## 📦 MixItUpBot Integration
+
+Brug `mixitup_integration.yaml` som eksempel til at oprette HTTP Requests i MixItUpBot.
+F.eks. en kommando der tænder en lampe:
+
+```yaml
+- Name: Tænd lampe
+  Type: Web Request
+  Method: POST
+  URL: http://[DIN_IP]:5001/control/turn_on/light.stue_lampe
+```
+
+## 🔐 Sikkerhed
+
+Denne proxy er kun til internt brug (LAN). Hvis du vil eksponere den eksternt:
+- Brug HTTPS via reverse proxy
+- Tilføj adgangskontrol (Basic Auth eller tokenbeskyttelse)
+
+## 💡 Mulige udvidelser
+
+- Gem og navngiv grupper (fx "Aftenlys")
+- API-kald fra Home Assistant til MixItUpBot
+- Notifikationer, scener eller script-styring
+
+---
+
+Lavet med ❤️ af [dig + ChatGPT]
diff --git a/git_banner.png b/git_banner.png
new file mode 100644
index 0000000..8df77fa
Binary files /dev/null and b/git_banner.png differ