Emailsorter/APPWRITE_CORS_SETUP.md

Appwrite CORS Setup - Schritt für Schritt

Problem

Appwrite blockiert Requests von https://emailsorter.webklar.com weil nur https://localhost als Origin erlaubt ist.

Lösung: Platform in Appwrite hinzufügen

Schritt 1: Appwrite-Konsole öffnen

1. Gehe zu: https://appwrite.webklar.com
2. Logge dich ein

Schritt 2: Projekt öffnen

1. Klicke auf dein EmailSorter Projekt (oder das Projekt, das du verwendest)

Schritt 3: Settings öffnen

1. Klicke auf Settings im linken Menü
2. Oder suche nach "Platforms" oder "Web" in den Einstellungen

Schritt 4: Platform hinzufügen

1. Klicke auf "Add Platform" oder "Create Platform"
2. Wähle "Web" als Platform-Typ

Schritt 5: Platform konfigurieren

Fülle die Felder aus:

• Name: Production (oder ein anderer Name)
• Hostname: emailsorter.webklar.com
• Origin: https://emailsorter.webklar.com

WICHTIG:

• Verwende https:// (nicht http://)
• Kein Slash am Ende
• Genau so wie oben geschrieben

Schritt 6: Speichern

1. Klicke auf "Create" oder "Save"
2. Warte 1-2 Minuten (Cache)

Schritt 7: Testen

1. Gehe zu https://emailsorter.webklar.com
2. Versuche dich einzuloggen
3. Prüfe die Browser-Konsole (F12) - sollte keine CORS-Fehler mehr geben

---

Alternative: Mehrere Origins

Falls du mehrere Domains brauchst (z.B. localhost für Development und Production):

1. Erstelle zwei separate Platforms:

   • Development: Hostname: localhost, Origin: http://localhost:5173
   • Production: Hostname: emailsorter.webklar.com, Origin: https://emailsorter.webklar.com

2. Oder verwende Wildcard (falls von Appwrite unterstützt):

   • Origin: https://*.webklar.com

---

Troubleshooting

CORS-Fehler bleibt bestehen

1. Cache leeren: Warte 2-3 Minuten nach dem Speichern
2. Browser-Cache: Strg+Shift+R (Hard Refresh)
3. Prüfe Origin: Muss genau https://emailsorter.webklar.com sein (kein Slash, kein Port)
4. Prüfe Appwrite-Version: Manche Versionen haben die Platform-Einstellungen an einem anderen Ort

Platform-Option nicht sichtbar

• In manchen Appwrite-Versionen heißt es "Web" statt "Platforms"
• Suche nach "Client" oder "SDK" in den Settings
• Prüfe die Appwrite-Dokumentation für deine Version

404 oder 403 Fehler

• Prüfe, ob die Appwrite-URL korrekt ist: https://appwrite.webklar.com
• Prüfe, ob du die richtigen Berechtigungen hast
• Prüfe, ob das Projekt existiert und aktiv ist

---

Screenshots (Beispiel)

Die Platform-Einstellungen sollten etwa so aussehen:

┌─────────────────────────────────────┐
│ Add Platform                        │
├─────────────────────────────────────┤
│ Type: [Web ▼]                      │
│                                     │
│ Name: Production                   │
│ Hostname: emailsorter.webklar.com   │
│ Origin: https://emailsorter.webklar │
│         .com                        │
│                                     │
│         [Cancel]  [Create]         │
└─────────────────────────────────────┘

---

Nach dem Setup

Nachdem du die Platform hinzugefügt hast:

1. ✅ CORS-Fehler sollten verschwinden
2. ✅ Login/Register sollte funktionieren
3. ✅ API-Calls sollten durchgehen

Falls es immer noch nicht funktioniert:

• Prüfe die Browser-Konsole für genaue Fehlermeldungen
• Prüfe die Appwrite-Logs (falls verfügbar)
• Stelle sicher, dass der Backend-Server läuft (502-Fehler beheben)