diff --git a/.gitignore b/.gitignore
index ba5587b..4029b5d 100644
--- a/.gitignore
+++ b/.gitignore
@@ -11,7 +11,11 @@ frontend/.env.local
 
 # Tooling / OS
 .idea/
-.vscode/
+# Die Start-Konfiguration gehört ins Repo (siehe README), persönliche
+# Einstellungen nicht. Der Ordner selbst darf nicht ausgeschlossen werden,
+# sonst greift die Ausnahme für die Datei darin nicht.
+.vscode/*
+!.vscode/launch.json
 *.iml
 .DS_Store
 *.log
diff --git a/.vscode/launch.json b/.vscode/launch.json
new file mode 100644
index 0000000..7298133
--- /dev/null
+++ b/.vscode/launch.json
@@ -0,0 +1,80 @@
+{
+  // Gesamtsystem starten: im Debug-Panel "SwyxWeb starten (Backend + Frontend)" wählen.
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "java",
+      "name": "Backend (Spring Boot)",
+      "request": "launch",
+      "mainClass": "de.appcreation.swyxweb.BackendApplication",
+      "projectName": "backend",
+      "cwd": "${workspaceFolder}/backend",
+      "console": "internalConsole"
+    },
+    {
+      // Wie oben, aber /api/config zeigt auf den eingebauten SwyxTray-Mock statt
+      // auf 192.168.180.135:17654 – so lässt sich die Startseite ohne echte
+      // Telefonanlage ausprobieren (eingehenden Anruf auslösen: siehe README).
+      "type": "java",
+      "name": "Backend (lokaler Test gegen SwyxTray-Mock)",
+      "request": "launch",
+      "mainClass": "de.appcreation.swyxweb.BackendApplication",
+      "projectName": "backend",
+      "cwd": "${workspaceFolder}/backend",
+      "console": "internalConsole",
+      "args": ["--app.websocket.host=localhost", "--app.websocket.port=8080"]
+    },
+    {
+      "type": "node-terminal",
+      "name": "Frontend (Vite + Chrome)",
+      "request": "launch",
+      "command": "npm run dev",
+      "cwd": "${workspaceFolder}/frontend",
+      // Wartet auf die von Vite ausgegebene URL und öffnet dann Chrome mit Debugger.
+      // Bewusst ohne "Local:"-Präfix im Muster: im Terminal steht dazwischen ANSI-Farbcode.
+      "serverReadyAction": {
+        "pattern": "(https?://localhost:[0-9]+)",
+        "uriFormat": "%s",
+        "action": "debugWithChrome",
+        "webRoot": "${workspaceFolder}/frontend"
+      }
+    },
+    {
+      "type": "node-terminal",
+      "name": "Frontend (nur Vite-Dev-Server)",
+      "request": "launch",
+      "command": "npm run dev",
+      "cwd": "${workspaceFolder}/frontend"
+    },
+    {
+      "type": "chrome",
+      "name": "Browser an laufenden Dev-Server hängen",
+      "request": "launch",
+      "url": "http://localhost:5173",
+      "webRoot": "${workspaceFolder}/frontend"
+    }
+  ],
+  "compounds": [
+    {
+      "name": "SwyxWeb starten (Backend + Frontend)",
+      "configurations": ["Backend (Spring Boot)", "Frontend (Vite + Chrome)"],
+      "stopAll": true,
+      "presentation": {
+        "group": "swyxweb",
+        "order": 1
+      }
+    },
+    {
+      "name": "SwyxWeb starten (lokaler Test gegen SwyxTray-Mock)",
+      "configurations": [
+        "Backend (lokaler Test gegen SwyxTray-Mock)",
+        "Frontend (Vite + Chrome)"
+      ],
+      "stopAll": true,
+      "presentation": {
+        "group": "swyxweb",
+        "order": 2
+      }
+    }
+  ]
+}