diff --git a/README.md b/README.md
new file mode 100644
index 0000000..345b81b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,43 @@
+def generate_readme():
+    content = """# 🎨 Windows 11 Ricing
+
+Willkommen in meinem **Windows 11 Ricing** Repository! Hier sammle ich meine Konfigurationen, Anpassungen und Dotfiles, um die Windows 11 Benutzeroberfläche nach meinen eigenen Vorstellungen zu gestalten und zu optimieren.
+
+## 📁 Repository-Struktur
+
+Dieses Repository enthält Konfigurationsdateien für verschiedene Anpassungstools:
+
+*   **`Windhawk/`**
+    Hier befinden sich Skripte und Mods für [Windhawk](https://windhawk.net/), ein Tool zur tiefgreifenden Anpassung von Windows-Programmen. 
+    *   *Aktuelle Mods:* Enthält u.a. Anpassungen für die Position des Startmenü-Buttons (`taskbar-start-button-position`).
+
+*   **`yasb/`**
+    Konfigurationen für **YASB** (Yet Another Status Bar), eine anpassbare Statusleiste für Windows.
+    *   *Styles:* Enthält angepasste CSS-Dateien (`styles.css`), um das Aussehen der Statusleiste perfekt in das System zu integrieren.
+
+## 🚀 Installation & Nutzung
+
+Um diese Konfigurationen zu nutzen, müssen die entsprechenden Tools auf deinem System installiert sein.
+
+### 1. Windhawk Mods anwenden
+1. Lade [Windhawk](https://windhawk.net/) herunter und installiere es.
+2. Öffne Windhawk und navigiere zu den Mods.
+3. Importiere oder kopiere die Skripte/Mods aus dem Ordner `Windhawk/` in deine Windhawk-Installation.
+
+### 2. YASB (Yet Another Status Bar) einrichten
+1. Installiere [YASB](https://github.com/amnweb/yasb) gemäß den Anweisungen im offiziellen Repository.
+2. Kopiere die Dateien aus dem `yasb/` Ordner (wie z.B. die `styles.css`) in dein lokales YASB-Konfigurationsverzeichnis (meistens unter `~/.yasb/` oder im AppData-Verzeichnis).
+3. Starte YASB neu, um die neuen Styles zu laden.
+
+## 🛠️ Verwendete Technologien & Sprachen
+*   **CSS:** (100%) - Hauptsächlich für das Styling der YASB Statusleiste.
+
+---
+*Dieses Repository wird aktiv gepflegt und um weitere Ricing-Komponenten für Windows 11 ergänzt.*
+"""
+    
+    with open("README.md", "w", encoding="utf-8") as f:
+        f.write(content)
+
+generate_readme()
+print("README.md generated successfully.")
\ No newline at end of file