“Try to Fix” error loops
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:1
Use the Try to Fix Button First
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.
2
Diagnose Unexpected Behavior
Your code may run without errors but not behave as intended. That’s unexpected behavior—harder to spot and harder to fix. Try this:
- Review your original prompt to confirm your instructions.
- Break it down: Check individual components and logic.
- Add visuals: Use screenshots to clarify what went wrong.
3
Write More Effective Prompts
Clear, structured prompts lead to better results. Use this format:
- Project Overview – What are you building?
- Page Structure – List key pages/components.
- Navigation Logic – Describe user flow.
- Visual Aids – Upload wireframes or screenshots.
- Implementation Steps – Lay out the build order.
4
Build in Logical Order
Structure matters. Follow this recommended flow:
- Create layout and pages.
- Connect Supabase or your backend.
- Set up authentication and user roles.
- Plan and organize feature logic.
- Prompt Lovable to implement features.
5
Use Chat Mode for Clarity
When unsure, switch to Chat Mode:
- Ask Lovable to analyze your project state.
- Request a recap of attempted solutions.
- Prompt for new directions to solve persistent problems.
6
If You're Still Stuck: Advanced Tactics
Still no luck? Try this:
- Be exact – Describe the bug and your expectations clearly.
- Use images – Screenshots or videos help illustrate problems.
- Ask directly – “What else can we try?”
- Rollback – Restore to a working version and rebuild incrementally.
What’s Going Wrong? Common Troubleshooting Areas
Troubleshooting generally falls into these categories:- UI or Layout Glitches
- API or Backend Issues
- Prompt Misinterpretations
- AI Unresponsiveness or Misbehavior
- Platform or Integration Errors
General issues
Need a fast diagnosis?
Need a fast diagnosis?
Jump into Chat-Only Mode and type: “Something’s off. Can you walk me through what’s happening and what you’ve tried?”
UI or Layout Problems
UI or Layout Problems
- Check component hierarchy and styles.
- Use screenshots to explain visual bugs.
- Prompt Lovable with: “Why is this element misaligned? Fix it.”
When completely stuck
When completely stuck
- 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.
Code sandbox error
Code sandbox error
This should not happen. Please report it to the support team.
Not found preview or spinning up sandbox
Not found preview or spinning up sandbox
Try a hard refresh. If unresolved, contact support.
AI Reliability
Avoiding AI mistakes in prompt engineering
Avoiding AI mistakes in prompt engineering
- Keep prompts clear and structured.
- Use reverse meta prompting.
- Test in Chat-Only Mode before applying big changes.
AI not responding
AI not responding
This shouldn’t happen. Please report it to the support team.
Persistent Fix error loops
Persistent Fix error loops
Adjust your prompt to help the AI understand your goal or ask for step-by-step debugging help.
Refactor broke everything
Refactor broke everything
Make small, incremental changes. If the issue persists, roll back to a stable version or debug in chat.
Error loops, hallucinations, or broken logic
Error loops, hallucinations, or broken logic
Revert to a stable version and provide more context in your next prompt. Use visual editor or attach a knowledge file.
AI not doing changes
AI not doing changes
The AI might be editing the wrong files or misinterpreting. Be very specific or edit manually.
Chat mode not responding or incomplete
Chat mode not responding or incomplete
This was fixed by engineering. Please report if it happens again.
Unexpected Crashes, Errors, or Loops
Unexpected Crashes, Errors, or Loops
- Don’t retry the same prompt. Simplify or rephrase.
- Ask: “What fixes have we already tried?”
- Rebuild from a previous working state.
Core functionalities
Preview is white
Preview is white
- Likely a runtime error. Check browser console logs.
- Use chat to troubleshoot.
- Try a hard refresh or revert.
Rollback fails
Rollback fails
Report to the support team if you can’t revert your project.
Unpublish or deactivate projects
Unpublish or deactivate projects
You can unpublish or delete your project in Project Settings.
Kicked out of project
Kicked out of project
This issue has been resolved. Report it if it recurs.
Remix doesn't work (no Supabase connection)
Remix doesn't work (no Supabase connection)
Shouldn’t happen. Contact support.
Loading profile error
Loading profile error
Shouldn’t happen. Report to the support team.
Email unsubscribe not working
Email unsubscribe not working
This is a serious issue likely related to our email provider. Contact support immediately.
Unexpected logout or access loss
Unexpected logout or access loss
Reach out to support directly.
Challenges with larger projects
Challenges with larger projects
- Break up large changes into smaller steps.
- Restart your browser if it slows down.
- If it persists, report your use case to support.
Supabase issues
Error with Edge Functions
Error with Edge Functions
- l Scope: Use the principle of least privilege for all credentials
Setting Environment Variables
Setting Environment Variables
Double-check syntax and variable names. See the Supabase docs.
Supabase connection is lost
Supabase connection is lost
Disconnect and reconnect. Might be caused by an integration update.
Remix does not work with Supabase
Remix does not work with Supabase
Remixing is blocked for Supabase-connected projects for security reasons.
Project not found
Project not found
Please report to support.
HTTP Fetch failures
HTTP Fetch failures
Usually means a backend server isn’t responding. Use chat mode to debug.
Connecting Supabase
Connecting Supabase
To connect your Lovable project to Supabase:
- Click the Supabase menu in the top right of the editor
- Select “Connect to Supabase”
- Follow the prompts to connect to your Supabase project
- Once connected, Lovable can see your tables, RLS policies, and functions
GitHub issues
Can't push to GitHub
Can't push to GitHub
You may have deleted your repo. Restore it here.
Branches are broken
Branches are broken
Branch switching is experimental. Use at your own risk.Once connected to GitHub, you can work with different branches:
Branch Switching Steps
Switching branches will change all files in your workspace to match that branch.
Branch Management:
- Create a new branch: Click “Create new branch” in the Git panel
- Delete a branch: Use the GitHub interface (not available directly in Lovable)
- Default branch: Set in GitHub repository settings
- Commit or stash any uncommitted changes
- Check if you have untracked files that would be overwritten
- Try refreshing the Lovable editor
Repository sync issues
Repository sync issues
- Check your GitHub permissions.
- Use rollback to undo unwanted changes.
Deleted repository, now nothing works
Deleted repository, now nothing works
Connecting GitHub
Connecting GitHub
To connect your Lovable project to GitHub:
- Click the GitHub button in the top right of the editor
- Authorize Lovable to access your GitHub account
- Choose whether to create a new repository or use an existing one
- Follow the prompts to complete the connection
Repository Access Levels:
When connecting Lovable to GitHub, you can choose different access levels:- All repositories: Access to all your GitHub repositories
- Only select repositories: Choose specific repositories to connect
Lovable uses GitHub’s OAuth flow for secure authentication. You can revoke access anytime from your GitHub account settings.
Authentication Issues
Authentication Issues
If you’re having trouble with GitHub authentication:
- Reconnect your GitHub account in Lovable
- Check if your GitHub access token has expired
- Verify you have the necessary permissions for the repository
- Ensure two-factor authentication isn’t blocking access
Failed Pushes
Failed Pushes
If your push is rejected:
- Pull the latest changes from the remote repository
- Resolve any conflicts
- Try pushing again
- If still failing, check if the branch is protected
Branches are broken
Branches are broken
This is an experimental feature. Expect occasional instability.
Deleted your repository
Deleted your repository
Need more help?
Still stuck? Try this:- Use Chat Mode for step-by-step help.
- Submit a bug through our Feedback Portal.
- If you’re a paid customer, contact Support.