Skip to main content
Codeezly

Troubleshooting

Encountering an issue? Find common problems and their solutions below. If your issue is not listed, use the support channels at the bottom.

Preview Issues

Preview shows a blank white page

  1. Check the Diagnostics panel below the editor for error messages.
  2. Look for missing imports or missing mount targets in the generated files.
  3. Try reverting to the last working commit via Version Control.

Preview is stuck on "Loading..."

The sandbox is still compiling. If it persists for more than 30 seconds:

  1. Click the Refresh button in the preview toolbar.
  2. Check if the AI is still generating and wait for completion.
  3. If the issue persists, refresh the page and reopen the workspace.

Preview shows runtime errors

  • Import errors: A file imports a symbol that does not exist.
  • Type errors: TypeScript mismatch or invalid props/state types.
  • Mount errors: Entry file mounts to an element not present in `index.html`.

AI Generation Issues

AI does not understand my prompt

  • Be specific about layout, behavior, and data states.
  • Break complex asks into smaller prompts.
  • Attach screenshots or references where possible.
  • See the AI Prompt Guide for prompt patterns.

AI is slow or times out

  • Large app generations can take 30-120 seconds.
  • Generate one feature/page at a time for better reliability.
  • Retry transient failures; infrastructure retries may already be in progress.

Deployment Issues

Build fails during deployment

  1. Inspect deployment logs for the first actionable error.
  2. Fix missing dependencies, unresolved imports, and type errors first.
  3. Ensure all required environment variables are set.

Deployed site differs from preview

  • Verify environment variables in production match local expectations.
  • Ensure API URLs are not pointing to localhost.
  • Confirm static assets are included in the deployment artifact.

Still Stuck?

  • Discord: Join our Discord community for real-time help.
  • Support Form: Use the Support page and include screenshots plus your project URL.
  • Diagnostics Export: In the workspace use Settings → Export Diagnostics and attach the bundle.