Building with Mocha makes coding faster and more intuitive—but even the best AI development tools can occasionally hit a snag. Sometimes your code won’t run as expected, or you might notice unexpected behavior where the AI interprets your intent incorrectly.

Here’s a step-by-step guide to help you navigate issues and get back on track:

1

Start with the Basics

Before diving deep into debugging, check the fundamentals:

  • Verify your internet connection is stable
  • Ensure you’re using a modern browser
  • Try refreshing the page to clear any temporary glitches
2

Analyze the Error Message

When you encounter an error:

  • Read the error message carefully - it often contains clues
  • If you see any relevant info on the screen, you can paste it into the prompt and ask Mocha to fix it
  • You can also paste screenshots of the error if it’s a visual issue
3

Use Discuss Mode for Complex Issues

For tricky problems, switch to Discuss Mode:

  • Have a conversation with Mocha about the issue
  • Let it reason through potential solutions
  • Get explanations for why certain approaches might work
  • Once you have a plan, switch back to Build Mode and ask Mocha to implement the solution
4

Try Incremental Changes

Instead of making large changes:

  • Make small, focused modifications
  • Test after each change
  • Keep track of what works and what doesn’t
  • Use version control to track your progress
5

Use Version Restoration

If you’ve gone down a problematic path, use version restoration:

  • Return to a previously working version
  • Compare what changed between versions
  • Identify which changes caused the issue
  • Try a different approach from the working version

​
Common Troubleshooting Areas

Troubleshooting generally falls into these categories:

UI or Layout Glitches

  • Use screenshots to explain visual bugs
  • Prompt Mocha clearly with what is wrong with the UI

Prompt Misinterpretations

  • Review your original instructions.
  • Break down complex requests
  • Use examples to clarify intent
  • Use restore rather than building upon a bad version

AI Unresponsiveness

  • Check your internet connection
  • Try refreshing the page
  • Contact support if persistent

​
When to Contact Support

The quickest response you’ll get is by going to our Discord server and asking for help there. The Mocha team is active there, and many community members will also help you out.

Contact Mocha support if you experience:

  • Persistent error loops that can’t be resolved
  • Critical functionality failures
  • Security concerns
  • Platform-wide issues

Remember: Mocha is here to help. If you’re stuck, don’t hesitate to:

  1. Use the Try to Fix button
  2. Switch to Chat-Only Mode
  3. Roll back to a working version
  4. Contact support if needed