Troubleshooting

Preview shows a blank page

• Wait a few seconds — the preview server may still be starting
• Check if the browser console shows errors (right-click > Inspect > Console)
• Ask the AI: "The preview is blank, can you check for errors?"
• Try clicking the refresh button in the preview toolbar

Preview shows an error

• Tell the AI: "The preview shows this error: [paste the error]"
• The AI can read error logs and fix the issue automatically
• If the error persists, try: "Please restart the frontend"

Changes are not showing in the preview

• The preview uses Hot Module Replacement (HMR) — changes should appear instantly
• If not, click the refresh button in the preview toolbar
• For backend changes, the backend may need a restart: "Please restart the backend"

"AI service error" message

• This is usually temporary. Try sending your message again
• If it persists, try refreshing the page
• Check if you have AI Tasks remaining in the sidebar

AI Tasks ran out

• Your current plan has a limited number of AI Tasks per month
• Upgrade your plan or purchase additional AI Task packs in Settings
• The sidebar shows your remaining AI Tasks

Published site shows a blank page

• Re-publish the project
• Check browser console for JavaScript errors
• Make sure all routes are configured correctly (ask the AI to check)

GitHub sync is not working

• Check if your GitHub account is still connected in Settings
• Make sure the repository exists and you have write access
• Try disconnecting and reconnecting GitHub

Database connection fails

• Check if PostgreSQL is enabled in the Integrations tab
• Environment variables are injected automatically — don't set DATABASE_URL manually
• For published sites, check if the Prod database was provisioned

Upload fails

• Check file size: maximum 10MB per file
• Supported image formats: JPG, PNG, GIF, WebP, SVG
• Supported documents: PDF, DOCX, XLSX, PPTX

The AI makes unwanted changes

• Be more specific in your requests: tell it exactly which file or section to change
• Use Design Mode to select the exact element
• If a change went wrong: "Undo the last change" or "Revert to the previous version"

Workspace is slow or unresponsive

• Close other browser tabs to free memory
• Try refreshing the page
• If the workspace container crashed, it restarts automatically within a minute