Sure! Pl

setup/API_KEY_SETUP.md

@@ -0,0 +1,53 @@
+# Appwrite API Key Setup
+
+## API Key erstellen
+
+1. **Appwrite Console oeffnen**: https://cloud.appwrite.io
+2. **Projekt auswaehlen**: Waehle dein Projekt (ID: `696b82bb0036d2e547ad`)
+3. **Settings > API Keys** navigieren
+4. **"Create API Key"** klicken
+5. **Konfiguration**:
+   - **Name**: `EShip Extension Key` (oder beliebiger Name)
+   - **Scopes**: 
+     - `users.read` - Benutzer lesen
+     - `users.write` - Benutzer erstellen/bearbeiten
+     - `sessions.write` - Sessions erstellen
+     - Optional: Weitere Scopes je nach Bedarf
+   - **Expiration**: Optional (leer lassen fuer unbegrenzt)
+6. **"Create"** klicken
+7. **API Key kopieren** - WICHTIG: Der Key wird nur einmal angezeigt!
+
+## API Key in Extension konfigurieren
+
+1. Oeffne `Extension/config.js`
+2. Fuege den API Key hinzu:
+
+```javascript
+var APPWRITE_CONFIG = {
+  endpoint: 'https://cloud.appwrite.io/v1',
+  projectId: '696b82bb0036d2e547ad',
+  apiKey: 'DEIN_API_KEY_HIER' // Hier den kopierten Key einfuegen
+};
+```
+
+3. Extension neu laden in `chrome://extensions`
+
+## Sicherheit
+
+- **NIEMALS** den API Key in Git committen
+- Der API Key sollte nur in der Extension verwendet werden
+- Bei Verlust: Alten Key loeschen und neuen erstellen
+- Verwende unterschiedliche Keys fuer Development und Production
+
+## Alternative: Environment-basierte Konfiguration
+
+Fuer Production kannst du den API Key auch ueber Chrome Storage setzen:
+
+1. In der Extension: `chrome.storage.local.set({ apiKey: 'DEIN_KEY' })`
+2. Im Service Worker: Key aus Storage laden
+
+## Troubleshooting
+
+- **"Invalid API Key"**: Pruefe, ob der Key korrekt kopiert wurde (keine Leerzeichen)
+- **"Insufficient permissions"**: Pruefe die Scopes des API Keys
+- **"Key expired"**: Erstelle einen neuen API Key