diff --git a/README.md b/README.md
index 8932a69..5cb36ce 100644
--- a/README.md
+++ b/README.md
@@ -1,61 +1,212 @@
-# Git Manager GUI
+# 🛠 Git Manager Explorer Pro
-**Ein einfacher Desktop-Git-Manager für GitHub & Gitea mit Drag & Drop Funktionalität.**
+[](https://github.com/M-Viper/git-manager-gui/releases)
+[](LICENSE)
+[](https://github.com/M-Viper/git-manager-gui)
-## Übersicht
-
-Git Manager GUI ermöglicht es dir, deine lokalen Projekte und Gitea/GitHub-Repositories bequem zu verwalten:
-
-- **Projekte durchsuchen** wie in einem Datei-Explorer
-- **Repositories laden** und direkt anzeigen
-- **Drag & Drop Upload/Download** von ganzen Projekten
-- **Repo erstellen**, aktualisieren und Pushen
-- **Dateien löschen, bearbeiten und previewen**
-
-Alles in einer **intuitiven Benutzeroberfläche**.
+**Eine moderne Desktop-Anwendung für vollständige Git-Repository-Verwaltung mit Gitea & GitHub.**
+Verwalte deine Repositories intuitiv ohne Kommandozeile — mit Favoriten, Verlauf, Editor und Batch-Aktionen.
---
-## Installation
+## ✨ Features
-1. Lade die **Windows-Installer-EXE** von der Release-Seite herunter.
-2. Führe die EXE aus und folge den Installationsschritten.
-3. Optional: Desktop-Shortcut erstellen lassen.
+### 🎯 Repository-Verwaltung
+- 📂 **Intelligente Repo-Übersicht** mit Tabs nach Besitzer und Fuzzy-Suche
+- 🌐 **Gitea & GitHub Support** — seamless integration mit beiden Plattformen
+- 🎯 **Favoriten & Verlauf** — schnelle Navigation zu liebsten Projekten
+- 📥 **Ein-Klick Migration** — repositories zwischen Services verschieben
+- 🚀 **Batch-Aktionen** — dieselbe Operation auf mehreren Repos gleichzeitig
-> Hinweis: Die App läuft **nur unter Windows**.
+### 💾 Datei-Verwaltung
+- ✏️ **Integrierter Editor** mit Syntax-Highlighting und Auto-Save
+- 📁 **Datei-Explorer** — navigiere durch Ordnerstruktur wie im Windows Explorer
+- 📤 **Drag & Drop Upload** — ziehe Dateien ins App-Fenster zum hochladen
+- 📥 **Drag & Drop Download** — ziehe Repos raus zum herunterladen
+- 🔄 **Rename & Move** — Dateien verwalten direkt im Editor
+
+### 📊 Versionscontrol
+- 📊 **Commit-History** mit Filter nach Autor und Nachricht
+- 🏷️ **Tag-Management** — Tags erstellen, bearbeiten, löschen
+- 📦 **Release-Verwaltung** — Releases und Assets verwalten
+- 📈 **Aktivitäts-Heatmap** — Commit-Historie visualisiert wie auf GitHub
+- 🔁 **Retry-Queue** — fehlgeschlagene Ops automatisch erneut versuchen
+
+### ⚙️ Erweiterte Funktionen
+- 🖼️ **Repo-Avatare hochladen** — Custom Projektbilder
+- 🏷️ **Auto-Topics** — Repositories mit Tags kategorisieren
+- 🔒 **Verschlüsselte Credentials** — alle Tokens AES-256 verschlüsselt
+- 🚀 **Auto-Startup** — App optional mit Windows starten
+- 🔄 **Auto-Update** — aktuelle Version automatisch verfügbar machen
---
-## Nutzung
+## 📋 Systemvoraussetzungen
-1. **Einstellungen**
- Öffne die Einstellungen und trage ein:
- - GitHub Token (für GitHub Repos)
- - Gitea Token & URL (für Gitea Repos)
-
-2. **Projekte laden**
- - Klicke auf **Load Gitea Repos**, um deine Repositories zu sehen
- - Wähle einen lokalen Ordner über **Select Folder** aus
-
-3. **Drag & Drop**
- - **Download**: Ziehe ein Repository aus der Liste auf deinen Desktop → komplettes Projekt wird heruntergeladen
- - **Upload**: Ziehe einen lokalen Projektordner auf ein Repository → Inhalte werden hochgeladen und in Git aktualisiert
-
-4. **Rechtsklick-Menü**
- - Auf Repositories klicken → Optionen wie **Download**, **Upload**, **Löschen**
-
-5. **Branches & Commits**
- - Branches auswählen und Commit-Logs einsehen
- - Push-Button zum Aktualisieren des Repos verwenden
+| Anforderung | Mindest | Empfohlen |
+|-------------|--------|----------|
+| **OS** | Windows 10 64-bit | Windows 11 |
+| **RAM** | 4 GB | 8 GB |
+| **Festplatte** | 200 MB | 1 GB (für Repos) |
+| **.NET** | Nicht erforderlich | — |
+| **Node.js** | Nicht erforderlich | — |
---
-## Support
+## 📦 Installation
-Bei Problemen oder Fragen kannst du ein Issue auf GitHub erstellen.
+### Über Installer (empfohlen)
+
+1. Gehe zu [Releases](https://github.com/M-Viper/git-manager-gui/releases)
+2. Lade die neueste `.exe`-Datei herunter
+3. Starte die EXE und folge dem Installations-Assistenten
+4. App startet automatisch nach Installation
+
+### Manuell (Entwickler)
+
+```bash
+git clone https://github.com/M-Viper/git-manager-gui.git
+cd git-manager-gui
+npm install
+npm start
+```
---
-## Lizenz
+## 🚀 Quick Start
+
+### 1️⃣ Credentials konfigurieren
+
+1. Starte die App
+2. Klicke auf **⚙️ Settings**
+3. Trage ein:
+ - **Gitea URL** (z. B. `https://git.example.com`)
+ - **Gitea Token** (von Gitea → Einstellungen → Anwendungen)
+ - **GitHub Token** (optional, für GitHub Repos)
+4. Klicke **Verbindung testen** → grüne Haken = erfolgreich ✓
+
+### 2️⃣ Repositories laden
+
+- Klicke **🌐 Load Gitea** um alle deine Repos zu sehen
+- Nutze die **Owner-Tabs** um nach Besitzer zu filtern
+- Nutze die **Fuzzy-Suche** um schnell ein Repo zu finden
+
+### 3️⃣ Repository öffnen
+
+- **Klick** auf eine Repository-Karte → Datei-Explorer
+- **Rechtsklick** → Kontextmenü mit Optionen (Favorit, Clone-URL, Tags, etc.)
+- **Drag & Drop** zum Download/Upload
+
+### 4️⃣ Dateien bearbeiten
+
+- Klick auf eine Textdatei → Editor öffnet sich
+- **Ctrl+S** zum Speichern (gepusht automatisch auf Gitea)
+- **Ctrl+F** zum Suchen & Ersetzen
+
+---
+
+## 📚 Dokumentation
+
+### Für Benutzer
+👉 **[HANDBUCH.html](HANDBUCH.html)** — Vollständiges Benutzerhandbuch
+ - Alle Features erklärt
+ - Schritt-für-Schritt Anleitungen
+ - Screenshots & Mockups
+ - Häufige Fehler & Lösungen
+
+### Für Entwickler
+👉 **[DEV_GUIDE.md](DEV_GUIDE.md)** — Entwicklerhandbuch
+ - Projektstruktur & Architektur
+ - Setup für lokale Entwicklung
+ - API-Integration & neue Features
+ - Code-Konventionen
+ - Build & Release-Prozess
+
+---
+
+## 🎮 Tastenkürzel
+
+| Shortcut | Aktion |
+|----------|--------|
+| Ctrl+K | Repo-Suche fokussieren |
+| Ctrl+S | Datei im Editor speichern |
+| Ctrl+F | Im Editor suchen |
+| Escape | Suche schließen |
+| Rechtsklick | Kontextmenü (Repos & Dateien) |
+| Drag raus | Datei/Repo herunterladen |
+| Drag rein | Datei hochladen |
+
+---
+
+## 🐛 Häufige Probleme
+
+### "401 Unauthorized"
+- **Ursache**: Token ungültig oder abgelaufen
+- **Lösung**: Neues Token auf Gitea generieren (Einstellungen → Anwendungen) und in Settings eintragen
+
+### "ECONNREFUSED" / Server nicht erreichbar
+- **Ursache**: Gitea-URL nicht korrekt oder Server down
+- **Lösung**: URL prüfen; bei IPv6: Klammern verwenden `http://[::1]:3000`
+
+### Repositories werden nicht angezeigt
+- **Ursache**: Owner-Tab "Meine" ist vorausgewählt (filtert fremde Repos)
+- **Lösung**: Tab "Alle" wählen oder nach Name suchen
+
+### Editor speichert nicht
+- **Ursache**: Token hat keine Schreibrechte
+- **Lösung**: Token-Berechtigungen prüfen (mindestens `repository:write` nötig)
+
+Weitere Lösungen im [HANDBUCH.html](HANDBUCH.html#häufige-fehler--lösungen).
+
+---
+
+## 🤝 Beitragen
+
+Fehler gefunden oder Idee für neue Features?
+
+1. [Erstelle ein Issue](https://github.com/M-Viper/git-manager-gui/issues/new) mit Beschreibung
+2. Fork das Repo und erstelle einen Branch: `git checkout -b feature/meine-idee`
+3. Commit deine Änderungen: `git commit -m "Add: meine neue Funktion"`
+4. Push zum Branch: `git push origin feature/meine-idee`
+5. Öffne einen Pull Request
+
+👉 Siehe [DEV_GUIDE.md](DEV_GUIDE.md) für Entwickler-Setup.
+
+---
+
+## 📝 Changelog
+
+### v2.1.3 (13. Mai 2026)
+- ✨ Projektname wird korrekt ausgeblendet bei Wechsel zur Übersicht
+- 🐛 Bug-Fix: Zurück-Button setzt Gravur korrekt zurück
+- 📚 Erweiterte Dokumentation (Benutzer- & Entwicklerhandbuch)
+
+### v2.1.0
+- 🎯 Neue Batch-Aktionen
+- 📊 Aktivitäts-Heatmap
+- 🔄 Verbesserte Fehlerbehandlung
+
+[Vollständiger Changelog →](https://github.com/M-Viper/git-manager-gui/releases)
+
+---
+
+## 📜 Lizenz
+
+Dieses Projekt ist unter der **MIT-Lizenz** lizenziert — siehe [LICENSE](LICENSE).
+
+---
+
+## 👤 Autor
+
+**M_Viper** — [GitHub](https://github.com/M-Viper) | [Website](https://m-viper.de)
+
+---
+
+## 💬 Support & Kontakt
+
+- 📧 **Email**: admin@m-viper.de
+- 🐛 **Issues**: [GitHub Issues](https://github.com/M-Viper/git-manager-gui/issues)
+- 📖 **Handbuch**: [HANDBUCH.html](HANDBUCH.html)
+- 👨💻 **Entwicklung**: [DEV_GUIDE.md](DEV_GUIDE.md)
Dieses Projekt ist Open-Source unter der [GPL Lizenz](LICENSE).