Zum Hauptinhalt springen
Diese Anleitung behandelt häufige Probleme und deren Lösungen bei der Arbeit mit Seemodo.

​
Sandbox-Probleme

​
Sandbox startet nicht

1

Anbieter-Konfiguration prüfen

Überprüfe ob deine .env Datei die richtigen Einstellungen hat:
SANDBOX_PROVIDER=modal
MODAL_BACKEND_URL=https://dein-backend.modal.run
2

Modal-Deployment verifizieren

Stelle sicher dass dein Modal-Backend deployed und aktiv ist:
cd modal-backend
modal deploy main.py
3

Netzwerk-Konnektivität prüfen

Dein Browser muss die Modal-Backend-URL erreichen können. Teste in einem neuen Tab.
4

Browser-Konsole überprüfen

Öffne DevTools (F12) und prüfe den Console-Tab auf Fehlermeldungen.

​
Vorschau lädt nicht

SymptomUrsacheLösung
Leerer iframeVite noch nicht bereit5-10 Sekunden warten, dann aktualisieren
Build-FehlerCode-FehlerKI-Chat auf Fehlermeldungen prüfen
TimeoutSandbox abgelaufenNeuen Screen generieren zum Neustart
CORS-FehlerTunnel-ProblemSeite aktualisieren versuchen

​
Sandbox läuft ständig ab

Das Standard-Timeout ist 60 Minuten. Zum Verlängern:
  1. Modifiziere config/app.config.ts: 
    modal: {
  timeoutMinutes: 120, // 2 Stunden
}
  2. Modal-Backend neu deployen

​
KI-Generierungsprobleme

​
Generierung schlägt fehl

Überprüfe deine KI-Anbieter-Schlüssel in .env:
GEMINI_API_KEY=dein_gültiger_key_hier
Teste den Schlüssel durch einen direkten API-Aufruf.
Bei vielen Anfragen kannst du Rate-Limits erreichen. Warte ein paar Minuten und versuche es erneut.
Sehr lange oder komplexe Prompts können fehlschlagen. Versuche:
  • In kleinere Teile aufzuteilen
  • Plan-Modus für komplexe Features zu nutzen
  • Spezifischer zu sein was du möchtest
Wenn ein bestimmtes Modell fehlschlägt, probiere ein anderes:
  • Füge ?model=true zur URL hinzu
  • Wähle ein alternatives Modell

​
Schlechte Ausgabequalität

1

Deep Design Modus nutzen

Aktiviere Deep Design in der Seitenleiste für bessere Ergebnisse.
2

Referenzbilder hinzufügen

Lade Screenshots oder Mockups hoch um die KI zu leiten.
3

Spezifischer sein

Statt “mach es schön”, spezifiziere Farben, Layout und Komponenten.
4

Anderes Modell probieren

Manche Modelle sind besser für bestimmte Design-Arten.

​
KI antwortet nicht

Wenn das Seemodo AI-Panel “Denkt” unbegrenzt anzeigt:
  1. Verbindungsanzeige prüfen (sollte grün sein)
  2. Reconnect-Button klicken
  3. Seite bei Bedarf aktualisieren
  4. Prüfen ob Sandbox noch läuft

​
Code-Probleme

​
Build-Fehler nach Generierung

Die KI erkennt und behebt die meisten Build-Fehler automatisch. Wenn ein Fehler bestehen bleibt:
  1. Fehlermeldung im KI-Chat prüfen
  2. KI spezifisch bitten es zu beheben: 
    Behebe den TypeScript-Fehler in Button.tsx
  3. Generierten Code auf offensichtliche Probleme prüfen

​
Fehlende Pakete

Pakete werden automatisch installiert, aber manchmal schlägt es fehl: 
# Im Sandbox-Terminal
pnpm add paket-name
Oder frag die KI: 
Installiere lodash und nutze es in der utils-Datei

​
HMR funktioniert nicht

Wenn Änderungen nicht in der Vorschau reflektiert werden:
  1. Klicke “Restart Vite” im Terminal
  2. Warte bis der Dev-Server neustartet
  3. Vorschau-iframe aktualisieren

​
Seemodo Cloud Probleme

​
Verbindung fehlgeschlagen

Die Projekt-Referenz ist nur die ID, nicht die vollständige URL:
  • ✅ Korrekt: abcdefghijklmnop
  • ❌ Falsch: https://abcdefghijklmnop.supabase.co
Hole einen neuen Token von Supabase Dashboard → Account → Access Tokens.Stelle sicher dass er die erforderlichen Berechtigungen hat.
Kostenlose Supabase-Projekte pausieren nach Inaktivität. Besuche das Dashboard zum Reaktivieren.

​
Datenbank-Operationen schlagen fehl

  1. Prüfe ob RLS-Policies die Operation nicht blockieren
  2. Verifiziere dass die Tabelle im richtigen Schema existiert
  3. Bitte die KI zu debuggen: 
    Warum schlägt das Insert in die users-Tabelle fehl?

​
Browser-Probleme

​
Langsame Performance

Zu viele offene Tabs

Schließe andere Tabs, besonders solche mit aktiven Sandboxes.

Browser-Cache

Cache leeren und Seite neu laden.

Extensions

Browser-Extensions deaktivieren die stören könnten.

Hardware-Beschleunigung

Stelle sicher dass Hardware-Beschleunigung in den Browser-Einstellungen aktiviert ist.

​
Canvas lädt nicht

tldraw erfordert WebGL-Unterstützung:
  1. Prüfe ob WebGL in deinem Browser aktiviert ist
  2. Aktualisiere deine Grafiktreiber
  3. Probiere einen anderen Browser (Chrome empfohlen)

​
Häufige Fehlermeldungen

FehlerBedeutungLösung
SANDBOX_NOT_FOUNDSandbox abgelaufen oder existiert nichtNeuen Screen generieren
SEEMODO_AI_CONNECTION_FAILEDSeemodo AI-Server nicht erreichbarWarten bis Sandbox vollständig initialisiert
MODEL_UNAVAILABLEKI-Modell nicht verfügbarAnderes Modell probieren
RATE_LIMIT_EXCEEDEDZu viele AnfragenEin paar Minuten warten
INSUFFICIENT_CREDITSKeine Credits mehrMehr kaufen oder auf Refresh warten

​
Hilfe bekommen

Wenn diese Lösungen dein Problem nicht beheben:
  1. Konsole prüfen - F12 drücken und nach Fehlermeldungen suchen
  2. Logs exportieren - Klicke “Export” im Seemodo AI-Panel
  3. Minimale Reproduktion erstellen - Notiere die genauen Schritte zur Reproduktion
  4. Support kontaktieren - E-Mail an [email protected] mit:
    • Browser- und Betriebssystem-Version
    • Schritte zur Reproduktion
    • Fehlermeldungen und Screenshots
    • Exportierte Logs wenn verfügbar