Integrations issues
Troubleshooting for integrations
The troubleshooting tips on this page assume some familiarity with the technologies used. For full guidance on using the integrations, check out the Integrations section. That section includes introductory information, so it’s a good starting point if you’re new to deployments, databases, and so on.
Bolt failed to deploy to Netlify
Manually deploy to Netlify:
- Run the project build command (usually
npm run build
). - Click Download to download the project.
- Follow Netlify’s Manual deploy instructions.
Bolt loses connection to Netlify when duplicating projects
If you fork or duplicate your project, you’ll need to reconnect to Netlify. Follow the steps in the Netlify integration guide.
Doing this will create a new Netlify site, so you’ll need to make sure your custom domains are pointed to the new site:
- If you bought your domain through Netlify and you’re using Netlify DNS, you can remove the domain from the old site, and add it to the new one, all in Netlify. This Netlify support answer provides more information.
- If you use another domain provider, look for their guide to updating domains.
GitHub authentication issues
This occurs when:
- You signed up for Bolt using a GitHub account.
- Then you created a new Bolt account, then try to connect the same GitHub account to this new account in the GitHub integration.
If you use GitHub for authentication to log in to Bolt, it’s also used by the GitHub integration by default. You can’t separate these uses.
To resolve this and use the GitHub account in the new Bolt account:
- Create a new login method for the old account:
- In the first Bolt account (where you originally signed up using GitHub), do a password reset using the email address associated with the GitHub account. This creates an email + password login for the Bolt account.
- Log out.
- Remove GitHub authentication from the old account:
- Log in to the old account using the email and password.
- Go to Settings > Credentials.
- On the GitHub section, click Delete.
- Connect the GitHub integration in the new account:
- Log in to the new account where you want to use the GitHub integration.
- Go through the steps to connect the GitHub integration as normal.
Supabase row level security rules aren’t working
Prompt Bolt to remove all the rules, then prompt to add the relevant row level security rule back in.
Supabase edge functions
This diagram outlines some example services users may want to use edge functions for, and how these interact with one another. At each point of interaction in the diagram, there is the potential for an error:
CORS (cross-origin resource sharing) errors
If your edge function isn’t working, it may be due to a CORS error. To check this:
-
Open Chrome DevTools: press
Command + Option + J
on Mac,Control + Shift + J
on Windows or Linux. -
Check the Network tab. Look for errors related to CORS.
-
Next, check if CORS headers are set correctly in the file responsible for your edge function. Here are the CORS headers for a chatbot built with Bolt using OpenAI:
You can use Discussion Mode to ask Bolt if CORS headers exist and are set correctly in your application.
Missing secret
When using edge fuctions with services like OpenAI, you must add the secret in the Edge Functions section of your project in Supabase. With your project open, hover over the left-hand side of the page and open Edge Functions > Secrets:
After doing this, prompt Bolt to make it aware of this update and continue development.
Webhooks: authorization headers and JWT
If you have a webhook that is invoked by a third-party service (for example, GitHub or Slack), you need to disable JWT verfication on your edge function in Supabase and add any forms of validation and authorization that are required. For example, GitHub describes the proper procedure for validating webhook deliveries.