Updated: January 27, 2025

This troubleshooting guide is designed to assist users encountering issues while using Bolt. If your specific issue is not listed here, please contact [email protected], and we'll ensure it gets added to the guide.

<aside> 💡

Before you jump down into the section that corresponds with the issue you are facing, please ensure that:

• You are using Chrome or a Chromium based browser as Bolt.new is the most compatible with these environments
• Selectively disable browser extensions, especially ad blockers, to see if this resolves the issue
• If accessing bolt.new through a VPN, try again with the VPN disabled

If you have confirmed that your issue is not resolved by the above, jump into the section that reflects the issue you are facing.

</aside>

White Screen / Grey Screen / No Preview showing

Supabase Issues

Prompt Too Long

Solutions to Common Error Messages

Below are common error messages you may encounter when building your application. While many of these will eventually be resolved by Bolt automatically, in the meantime you can apply the manual fixes listed for these specific errors below.

Additional Troubleshooting

If you have received an error message that is not described above, you can try two things:

1. Copy and past the error message itself directly into Bolt and ask it to resolve the problem.
2. Research the error message using another LLM (such as ChatGPT) and paste the described solutions back into Bolt.

Note: If neither of these methods, then Bolt will not be able to resolve your issue as it stands. In this case, you will need to research the problem, such as by consulting official documentation, and apply a fix manually.