diff --git a/docs/de/get-started.md b/docs/de/get-started.md
new file mode 100644
index 0000000..b2fbdd3
--- /dev/null
+++ b/docs/de/get-started.md
@@ -0,0 +1,68 @@
+# Erste Schritte
+
+Sky Follower Bridge hilft Ihnen, Ihre Verbindungen von 𝕏 (Twitter) auf Bluesky zu finden und zu folgen.
+
+
+
+## Installation
+
+Sky Follower Bridge ist verfügbar auf:
+
+
+
+::: tip
+Wir empfehlen die Verwendung der Chrome Web Store-Version, da sie immer auf dem neuesten Stand ist. Andere Store-Versionen können bei Updates hinterherhinken.
+:::
+
+::: warning
+Sky Follower Bridge ist nur für Desktop-Browser verfügbar. Mobile Browser werden nicht unterstützt.
+:::
+
+### 4. Suche starten
+
+Klicken Sie auf "Find Bluesky Users", um den Scan zu starten. Die Erweiterung sucht nach passenden Bluesky-Profilen, indem sie die Bluesky-API überprüft.
+
+
+
+### 5. Ergebnisse überprüfen
+
+Klicken Sie auf "View Results", um die potenziellen Übereinstimmungen auf Bluesky zu sehen.
+
+
+
+Dies öffnet die Optionsseite, die alle erkannten Bluesky-Benutzer anzeigt.
+
+
+
+### 6. Benutzer folgen
+
+Klicken Sie auf die Schaltfläche "Follow" neben jedem Benutzer, mit dem Sie sich verbinden möchten.
+
+
+
+oder verwenden Sie die Schaltfläche "Follow All", um alle erkannten Benutzer auf einmal zu folgen.
+
+
+
+::: warning
+Bitte beachten Sie, dass der Abgleichsprozess nicht perfekt ist und gelegentlich falsche Übereinstimmungen vorschlagen kann. Überprüfen Sie immer das Profil, bevor Sie folgen.
+:::
+
+Das ist alles! Viel Spaß beim Verbinden mit Ihrer Community auf Bluesky 🎉
diff --git a/docs/de/index.md b/docs/de/index.md
new file mode 100644
index 0000000..c7590f8
--- /dev/null
+++ b/docs/de/index.md
@@ -0,0 +1,32 @@
+---
+layout: home
+
+hero:
+ name: "Sky Follower Bridge"
+ text: "Verbinden Sie Ihre sozialen Netzwerke"
+ tagline: Migrieren Sie Ihre sozialen Verbindungen mühelos von 𝕏 zu Bluesky
+ actions:
+ - theme: brand
+ text: Erste Schritte
+ link: /de/get-started
+ - theme: alt
+ text: Fehlerbehebung
+ link: /de/troubleshooting
+ image:
+ src: /images/logo.webp
+ alt: Sky Follower Bridge Titelbild
+
+features:
+ - icon: 🔍
+ title: Automatische Profilabstimmung
+ details: Erkennen Sie automatisch Bluesky-Benutzer, die Ihren 𝕏-Follows ähneln.
+ - icon: 🚀
+ title: Massenfolgen-Funktion
+ details: Sparen Sie Zeit, indem Sie mehrere Benutzer gleichzeitig mit unserer "Follow All"-Schaltfläche folgen.
+ - icon: 📋
+ title: Unterstützung für mehrere Listen
+ details: Funktioniert mit Listen von Follows, Blockierten und sogar öffentlichen 𝕏-Listen.
+ - icon: 🌐
+ title: Unterstützung für mehrere Browser
+ details: Verfügbar auf Chrome, Firefox und Microsoft Edge für Ihre Bequemlichkeit.
+---
diff --git a/docs/de/troubleshooting.md b/docs/de/troubleshooting.md
new file mode 100644
index 0000000..91a8a10
--- /dev/null
+++ b/docs/de/troubleshooting.md
@@ -0,0 +1,68 @@
+# Fehlerbehebung
+
+## Authentifizierungsfehler
+
+### Anmeldeprobleme
+
+**Fehlermeldung:**
+Error: Invalid identifier or password
+
+**Checkliste:**
+1. Eingabe von Benutzername und Passwort
+ - Überprüfen Sie auf versehentliche Leerzeichen
+ - Wenn Sie kopieren und einfügen, stellen Sie sicher, dass keine zusätzlichen Zeichen enthalten sind
+
+2. Benutzername-Format
+ - Richtiges Format: `your-username.bsky.social`
+ - Häufiger Fehler: `your-username` (fehlt .bsky.social)
+
+3. Passwortinformationen
+ - Wir empfehlen dringend die Verwendung eines [App Password](https://bsky.app/settings/app-passwords) anstelle Ihres regulären Passworts
+ - Format des App Password: `xxxx-xxxx-xxxx-xxxx` (19 Zeichen)
+
+::: tip Nützliche Tipps
+Verwechseln Sie das App Password nicht mit dem "password name", der in den Einstellungen angezeigt wird.
+So erstellen Sie ein neues App Password:
+1. [Gehen Sie zum Abschnitt App Passwords](https://bsky.app/settings/app-passwords)
+2. Klicken Sie auf "Add App Password"
+3. Klicken Sie auf "Create App Password"
+4. Kopieren Sie das generierte 19-stellige Passwort
+:::
+
+### Zwei-Faktor-Authentifizierung erforderlich
+
+**Fehlermeldung:**
+...
+
+## Scan-Probleme
+
+### Der Button "View Detected Users" funktioniert nicht
+
+...
+
+### Scan stoppt frühzeitig
+
+...
+
+### Keine Benutzer gefunden
+
+...
+
+**Lösung:**
+1. Stellen Sie sicher, dass Sie korrekt angemeldet sind
+2. Versuchen Sie erneut zu scannen - einige Benutzer werden möglicherweise beim ersten Durchlauf nicht erkannt
+3. Überprüfen Sie, ob 𝕏-Benutzer ihre Bluesky-Konten in ihren Profilen verlinkt haben
+
+## Andere Probleme
+
+Wenn Sie unerwartete Fehler feststellen:
+
+1. Laden Sie die Seite neu
+2. Versuchen Sie die Operation erneut
+3. Wenn das Problem weiterhin besteht, können Sie:
+ - [Ein Problem erstellen](https://github.com/kawamataryo/sky-follower-bridge/issues) mit:
+ - Der genauen Fehlermeldung
+ - Was Sie zu tun versuchten
+ - Ihrem Browsertyp und -version
+ - Relevante Screenshots
+ - Oder erwähnen Sie [@kawamataryo.bsky.social](https://bsky.app/profile/kawamataryo.bsky.social) auf Bluesky