Sandbox Issues
Sandbox not starting
Check network connectivity
Your browser must be able to reach the Modal backend URL. Test in a new tab.
Preview not loading
| Symptom | Cause | Solution |
|---|---|---|
| Blank iframe | Vite not ready | Wait 5-10 seconds, then refresh |
| Build error | Code error | Check AI chat for error messages |
| Timeout | Sandbox expired | Generate a new screen to restart |
| CORS error | Tunnel issue | Try refreshing the page |
Sandbox keeps timing out
The default timeout is 60 minutes. To extend:- Modify
config/app.config.ts: - Redeploy the Modal backend
AI Generation Issues
Generation fails
Invalid API key
Invalid API key
Verify your AI provider keys in Test the key by making a direct API call.
.env:Rate limiting
Rate limiting
If you’re making many requests, you may hit rate limits. Wait a few minutes and try again.
Prompt too complex
Prompt too complex
Very long or complex prompts may fail. Try:
- Breaking into smaller pieces
- Using Plan mode for complex features
- Being more specific about what you want
Model unavailable
Model unavailable
Poor quality output
AI not responding
If the Seemodo AI panel shows “Thinking” indefinitely:- Check the connection indicator (should be green)
- Click the Reconnect button
- Refresh the page if needed
- Check if the sandbox is still running
Code Issues
Build errors after generation
The AI automatically detects and fixes most build errors. If an error persists:- Check the error message in the AI chat
- Ask the AI specifically to fix it:
- Review the generated code for obvious issues
Missing packages
Packages are auto-installed, but sometimes fail:HMR not working
If changes aren’t reflecting in the preview:- Click “Restart Vite” in the terminal
- Wait for the dev server to restart
- Refresh the preview iframe
Seemodo Cloud Issues
Connection failed
Invalid project reference
Invalid project reference
The project reference is just the ID, not the full URL:
- ✅ Correct:
abcdefghijklmnop - ❌ Wrong:
https://abcdefghijklmnop.supabase.co
Invalid API token
Invalid API token
Get a new token from Supabase Dashboard → Account → Access Tokens.Ensure it has the required permissions.
Project paused
Project paused
Free Supabase projects pause after inactivity. Visit the dashboard to resume.
Database operations failing
- Check RLS policies aren’t blocking the operation
- Verify the table exists in the correct schema
- Ask the AI to debug:
Browser Issues
Slow performance
Too many open tabs
Close other tabs, especially those with active sandboxes.
Browser cache
Clear cache and reload the page.
Extensions
Disable browser extensions that might interfere.
Hardware acceleration
Ensure hardware acceleration is enabled in browser settings.
Canvas not loading
tldraw requires WebGL support:- Check that WebGL is enabled in your browser
- Update your graphics drivers
- Try a different browser (Chrome recommended)
Common Error Messages
| Error | Meaning | Solution |
|---|---|---|
SANDBOX_NOT_FOUND | Sandbox expired or doesn’t exist | Generate a new screen |
SEEMODO_AI_CONNECTION_FAILED | Can’t reach Seemodo AI server | Wait for sandbox to fully initialize |
MODEL_UNAVAILABLE | AI model is down | Try a different model |
RATE_LIMIT_EXCEEDED | Too many requests | Wait a few minutes |
INSUFFICIENT_CREDITS | Out of credits | Purchase more or wait for refresh |
Getting Help
If these solutions don’t resolve your issue:- Check the console - Press F12 and look for error messages
- Export logs - Click “Export” in the Seemodo AI panel
- Create a minimal reproduction - Note the exact steps to reproduce
- Contact support - Email [email protected] with:
- Browser and OS version
- Steps to reproduce
- Error messages and screenshots
- Exported logs if available