Skip to main content

General troubleshooting workflow

Standard steps

Step 1: Understand
  • Copy error messages
  • Ask the AI what they mean and where the bug might be
  • Do not ask for random code changes on sight
Step 2: Troubleshoot
  • Click Troubleshoot
  • Let the system fix common issues
  • Troubleshoot is free and does not use Compute Credits
Step 3: Consult
  • If Troubleshoot fails, use consultation mode
  • Discuss options with the AI
  • Execute only after alignment
Step 4: Roll back
  • For complex regressions, roll back to a good version
  • Try a different fix path
  • Avoid error spirals
Step 5: Network and cache
  • Check connectivity
  • Clear browser cache
  • Try another browser
💡 Tip: Understand first, then fix. Troubleshoot is free — try it early. Most issues resolve with Troubleshoot, consultation, rollback, and cache clears.

System errors

Errors during generation

Symptoms
  • Network errors while generating
  • Task stuck in progress
  • Chat frozen
Fixes
  1. Wait: Ignore transient errors until generation finishes
  2. Verify: Check the project after completion
  3. Troubleshoot: If problems remain, click Troubleshoot
  4. Regenerate: Roll back or regenerate if Troubleshoot fails
💡 Tip: Mid-generation errors are often temporary — wait for completion before deciding.

Network error after Troubleshoot

Symptoms
  • Network errors after Troubleshoot
  • Project feels broken
Fixes
  1. Refresh: Reload the page
  2. Troubleshoot again: Click Troubleshoot under the chat
  3. Wait: Allow auto-recovery
  4. Verify: Confirm the project recovered
💡 Tip: Refresh and Troubleshoot again — usually enough.

Data loss recovery

Symptoms
  • Empty project after service shutdown
  • Data cleared
Fixes
  1. Top up: Recharge on Account
  2. Auto recovery: Services and data restore after top-up
  3. Manual recovery if needed:
  • Click Troubleshoot
  • Launch → Publish → Update to republish
Prevention
  • Monitor Compute Credits balance
  • Act on low-balance alerts
  • Back up important projects regularly
⚠️ Note: After shutdown, some data may be cleared. Keep enough balance to avoid unexpected stops.