> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovable.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Troubleshooting
> Fix build errors, debug unexpected behavior, resolve preview issues, and recover from common problems step by step.
## Build errors
Building with Lovable 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:
Click the **Try to Fix** button when an error shows up. Lovable will scan your logs, detect the issue, and attempt a quick fix. It's your fastest first move. If that doesn't work, it's time to dig deeper.
Your code may run without errors but not behave as intended. That's **unexpected behavior**, harder to spot and harder to fix. Try this:
* **Revert and re‑prompt**: Roll back to just before the issue occurred, then try a clearer, revised prompt.
Clear, structured prompts lead to better results. Use this format:
1. **Use Plan mode** and ask, "Can you outline the steps or plan for this feature?"
2. **Review the plan** that Lovable suggests, ask for changes or clarifications if needed.
3. **Prompt Lovable**: "Now, let's build this step by step."
Structure matters. Follow this recommended flow:
1. Create layout and pages.
2. Connect to Lovable Cloud or an external Supabase connection.
3. Set up authentication and user roles.
4. Plan and organize feature logic.
5. Prompt Lovable to implement features.
### General issues
Jump into Chat-Only Mode and type: "This specific function is not working. Can you walk me through what's happening and what you've tried?"
* Provide screenshots of the UI issue directly to the AI for a clearer diagnosis.
* Use the Edit tool to select and highlight specific UI features you want to change, then describe the adjustment you want.
* For example: "See the highlighted element? Center it vertically and increase padding."
* Prompt: "Take a step back. Analyze the error and suggest a different approach."
* Break the task into smaller parts.
* Use the revert button if errors persist.
Issues with the preview not found or the sandbox spinning up can be related to either the sandbox environment or your connection. Sandbox problems are often temporary, try a hard refresh first. If this continues, it may indicate a broken sync with GitHub or a connection issue. For persistent issues, review our [GitHub integration guide](https://docs.lovable.dev/integrations/github).
### Core functionalities
* These are often the result of issues in the vite.config.ts file or that security headers have been introduced into the project.
* Build errors or syntax errors in the code
* JavaScript runtime errors causing crashes
* Missing dependencies or broken components
* Authentication or routing issues blocking the page
To troubleshoot: Ask Lovable to review the vite.config.ts file or remove security headers. Check browser console for errors, revert to an earlier version, or ask Lovable to investigate the blank screen issue.
You can unpublish or delete your project in Project Settings.
Check the Cloud tab -> Logs for specific error messages. Verify all required secrets and environment variables are properly configured. Try redeploying by making a small change to the edge function code by prompting Lovable. Ensure your database connection is working. Ask Lovable to investigate the specific error and fix any issues found in the logs.
This usually means the project was deleted. If you didn't delete it on purpose, please reach out to support for help restoring your project.
### Need more help?
Still stuck? Try this:
1. Use Plan mode for step-by-step help.
2. If it's an issue with the UI or a feature, revert back to a stable state.
3. If you're a paid customer and want to report a platform-wide issue, contact [Support](https://lovable.dev/support).