Troubleshooting Guide

Common problems and their solutions for CodeVibe projects

Common Problems and Solutions

Project Won't Start

• Make sure Node.js is installed (version 18+)
• Run npm install to install dependencies
• Run rm -rf .next
• Try npm run dev again

Build Failed

• Check for TypeScript errors in your files
• Make sure all imported files exist
• Verify all dependencies are installed
• Check file paths in import statements

Deploy Not Successful

• Make sure you're logged into Cloudflare
• Run npm run build before deploy
• Check your internet connection
• Ensure the wrangler.jsonc name is unique

Internal Server Error

• Kill the process (Ctrl+C) and restart
• Usually happens when the dev server crashes

Getting Help

ٰVibeAI

Ask ٰVibeAI for help with specific errors:

"Fix this error: [paste your error message]"

If you don't understand any other error, go to the AI inside the editor (ٰVibeAI).

Check Logs

Always check the terminal and browser console for error messages.

• Terminal: Shows build and runtime errors
• Browser Console: Shows client-side JavaScript errors
• Network tab: Shows failed requests

Prevention Tips

✓Always test with npm run dev after changes
✓Keep changes small and test them one by one
✓Use GitHub for backups of working versions
✓Check the browser console regularly
✓Read error messages carefully - they often tell you exactly what's wrong