diff --git a/README.md b/README.md
index d23d95a..80796c9 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,42 @@
-# dotfiles
+# 🇩🇪 Deutsch
+### 🚀 Ultimate Dotfiles Setup
+Dieses Repository enthält ein intelligentes Cross-Platform Setup-Skript, das automatisch die Systemumgebung erkennt (Arch, Debian, Alpine, Termux) und eine maßgeschneiderte ZSH- und Neovim-Konfiguration installiert.
 
+### 📋 Features
+- Automatische OS-Erkennung - Erkennt Distributionen via /etc/os-release oder Termux-Umgebungen.
+
+- Smart Fallback - Erkennt Derivate (wie CachyOS) und nutzt automatisch die Konfiguration der Basis-Distro (Arch), falls keine spezifische Datei existiert.
+
+- Minimalistisches Setup - Installiert nur die notwendigen Pakete (zsh, neovim, eza, fastfetch, git).
+
+- Custom Configs - Lädt systemspezifische .zshrc Profile direkt von Gitea.
+
+- POSIX-konform - Funktioniert auch auf Minimal-Systemen wie Alpine Linux ohne bash.
+
+### Installation
+Führe diesen Befehl auf einem frischen System aus:
+```sh
+curl -fsSL https://git.ungruhe.info/Tim/dotfiles/raw/branch/main/setup.sh | sh
+```
+
+---
+# 🇺🇸 English
+### 🚀 Ultimate Dotfiles Setup
+This repository features an intelligent cross-platform setup script that automatically detects your system environment (Arch, Debian, Alpine, Termux) and deploys a tailored ZSH and Neovim configuration.
+
+### 📋 Features
+- Automatic OS Detection - Detects distributions via /etc/os-release or Termux environments.
+
+- Smart Fallback - Detects derivatives (e.g., CachyOS) and automatically uses the base distribution's config (Arch) if no specific file exists.
+
+- Lightweight Setup - Installs core packages only (zsh, neovim, eza, fastfetch, git).
+
+- Custom Configs - Pulls system-specific .zshrc profiles directly from Gitea.
+
+- POSIX Compliant - Works on minimal systems like Alpine Linux without requiring bash.
+
+### Insallation
+Run this command on a fresh system:
+```sh
+curl -fsSL https://git.ungruhe.info/Tim/dotfiles/raw/branch/main/setup.sh | sh
+```
\ No newline at end of file