Troubleshooting

Symptoms: White screen, infinite loading, or error in preview panel.

Solutions:

1. Refresh the preview: Click the refresh button in the preview toolbar
2. Check for errors: Look for error messages in the chat
3. Restart dev server: Ask "restart the dev server"
4. Clear cache: Hard refresh with Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows)

Symptoms: Styles missing, layout broken, or old content showing.

Solutions:

1. Force refresh: The preview might be cached
2. Check the code: Ask "is there an error in the code?"
3. Rollback: Use version control to restore a working version

Symptoms: "Build failed" message when publishing.

Common causes:

1. Syntax errors: Ask "fix any syntax errors in the code"
2. Missing dependencies: Ask "are all dependencies installed?"
3. Import errors: Ask "check for broken imports"

Symptoms: Type errors preventing build.

Solutions:

Ask the AI to fix them:

"Fix the TypeScript errors in the project"

Symptoms: Published site shows old content.

Solutions:

1. Wait: Deployments can take up to 2 minutes
2. Clear CDN cache: May take a few minutes to propagate
3. Hard refresh: Cmd+Shift+R on the live site

Symptoms: Domain not resolving or SSL errors.

Solutions:

1. Check DNS: Ensure CNAME is correct
2. Wait for propagation: DNS can take up to 48 hours
3. Verify domain: Check domain settings in project

See Custom Domains for setup guide.

Symptoms: No response from AI, or "thinking" forever.

Solutions:

1. Refresh the page: Simple fix often works
2. Check your credits: Ensure you have credits available
3. Try again: Sometimes queries need a retry

Symptoms: AI changes things you didn't ask for.

Solutions:

1. Be more specific: Tell the AI exactly what to change
2. Scope your request: "Only in the header..."
3. Rollback: Use version control to undo

Symptoms: CMS changes not persisting.

Solutions:

1. Wait for save: Changes auto-save, give it a moment
2. Check for errors: Look for error messages
3. Refresh CMS: Navigate away and back