Troubleshooting
Actionable steps to resolve issues in your development lifecycle.
“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:
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.
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.
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.
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.
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.
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
Use the accordions below to identify specific issues and actions:
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
This action isn’t currently supported.
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.
Domain Issues
Custom Domain Setup
Custom Domain Setup
To connect your custom domain to your Lovable app:
- Navigate to Project → Settings → Domains in Lovable
- Click “Add Domain” and enter your domain name
- Update your DNS settings as instructed
- Wait for DNS propagation (can take up to 48 hours)
Custom domain functionality requires a paid Lovable plan.
DNS Configuration
DNS Configuration
Example DNS settings for your domain registrar:
DNS Settings Explanation:
- A Record: Points your root domain to Lovable’s IP address
- CNAME Record: Creates an alias from www to your Lovable app
- TTL (Time-to-Live): Set to 3600 (1 hour) or lower for faster propagation
DNS Verification:
To verify your DNS settings are correct, you can use:
- DNSChecker.org
- MXToolbox
- Command line:
dig example.comornslookup example.com
SSL Certificate Issues
SSL Certificate Issues
Lovable automatically provisions SSL certificates for custom domains. If you’re experiencing SSL issues:
- Ensure your DNS is properly configured
- Check if your domain has CAA records that might restrict certificate issuance
- Wait up to 24 hours for the certificate to be issued
- Verify your browser isn’t caching an old certificate
- Check for certificate transparency logs to see if a certificate was issued
- Contact Lovable support if issues persist
Common SSL Errors:
- ERR_CERT_COMMON_NAME_INVALID: Domain doesn’t match certificate
- ERR_CERT_AUTHORITY_INVALID: Certificate not trusted by browser
- SEC_ERROR_UNKNOWN_ISSUER: Certificate issuer unknown
- SSL_ERROR_BAD_CERT_DOMAIN: Domain doesn’t match certificate
**SSL Security Note: **Lovable uses Let’s Encrypt to provision SSL certificates. These certificates are valid for 90 days and are automatically renewed.
Deployment Process
Deployment Process
To deploy your Lovable app:
- Click the “Publish” button in the top-right corner
- Wait for the build process to complete
- Your app will be available at yourapp.lovable.app
- Review deployment logs for any issues
Deployment Strategies:
- Preview Deployments: Test your app before publishing to production
- Automatic Deployments: Configure your project to deploy automatically on Git changes
- Rollbacks: Revert to previous versions if needed
Removing Lovable Badge
Removing Lovable Badge
To remove the Lovable badge from your deployed app:
- Go to Project Settings
- Find “Show Lovable Badge” option
- Toggle it off (requires paid plan)
- Redeploy your application
The badge removal option is available on all paid plans. If you don’t see this option, make sure your billing is up to date.
Published version not showing latest version
Published version not showing latest version
Current workaround is user having to add both the domain as well as www. domain counterpart to get the updates to sync.
Supabase issues
Error with Edge Functions
Error with Edge Functions
- l Scope: Use the principle of least privilege for all credentials
When using Lovable with Supabase, always store sensitive API keys as Supabase Edge Function secrets rather than environment variables or in source code.
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
Stripe issues
Stripe error
Stripe error
Try a different card or payment method. Contact support if unresolved.
Two active subscriptions
Two active subscriptions
Don’t worry—support can easily fix this.
Cancel your subscription
Cancel your subscription
Go to your settings and cancel via Stripe account.
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
If you can’t switch branches:
- 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.
Comprehensive Debugging Manual
This document or this website were written by a Lovable power user in our Discord community.
How to use it
- Download it as
Comprehensive_Debugging_Manual.md. - Upload it to your GitHub project.
- Prompt Lovable: “Read this document. Let me know if it helps. Then create a prompt I should use to troubleshoot this issue.”
- After Lovable responds, say: “Before you proceed, explain in detail why you think this will work. Wait for my approval.”
This ensures deeper understanding before implementing any fix.