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:

  1. Run the project build command (usually npm run build).
  2. Click Download to download the project.
  3. 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:

  1. You signed up for Bolt using a GitHub account.
  2. 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:

  1. Create a new login method for the old account:
    1. 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.
    2. Log out.
  2. Remove GitHub authentication from the old account:
    1. Log in to the old account using the email and password.
    2. Go to Settings > Credentials.
    3. On the GitHub section, click Delete.
  3. Connect the GitHub integration in the new account:
    1. Log in to the new account where you want to use the GitHub integration.
    2. 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.