22 troubleshooting guides

Bolt Errors and Fixes

Step-by-step fixes for the most common Bolt build, auth, deploy, and integration problems.

Quick Answer

Start with the exact symptom, then verify environment variables, auth redirects, and integration setup before changing code. These 22 Bolt fixes are grouped so you can go straight to the failing workflow.

Featured Bolt fixes

deploy

npm Package Not Working in Bolt.new

npm install fails with compile errors

deploy

Bolt.new App Not Deploying

Deploy button doesn't work

prompting

Bolt.new Forgetting Previous Instructions

Bolt contradicts earlier decisions

deploy

Bolt.new Preview Not Updating

Preview shows old version

prompting

Bolt.new Daily Credits Exhausted

'Credits exhausted' message

database

Bolt.new Data Not Persisting Between Sessions

Data disappears on page refresh

All Bolt fixes

intermediate

npm Package Not Working in Bolt.new

npm install fails with compile errors

beginner

Bolt.new App Not Deploying

Deploy button doesn't work

beginner

Bolt.new Forgetting Previous Instructions

Bolt contradicts earlier decisions

beginner

Bolt.new Preview Not Updating

Preview shows old version

beginner

Bolt.new Daily Credits Exhausted

'Credits exhausted' message

beginner

Bolt.new Data Not Persisting Between Sessions

Data disappears on page refresh

intermediate

TypeScript Strict Mode Errors in Bolt.new

Red errors throughout the editor

intermediate

CORS Error in Bolt.new App

'Access-Control-Allow-Origin' error in console

beginner

Bolt.new Styling Looks Different Every Time

New components don't match existing design

beginner

Bolt.new Stuck in Infinite Loading

Spinner never stops

Supabaseintermediate

Bolt Supabase RLS Blocking Inserts

Form submits in Bolt but no row appears in Supabase

Supabasebeginner

Bolt Supabase Auth Session Missing After Refresh

User signs in successfully, then gets logged out on refresh

Supabasebeginner

Bolt Supabase Storage Upload Failing

File picker works but the upload fails

Stripeintermediate

Bolt Stripe Checkout Session Returning 400

Stripe checkout creation fails with a 400 error

Stripeintermediate

Bolt Stripe Webhook Not Updating Access

Payment succeeds but the user never gets access

Stripeintermediate

Bolt Stripe Billing Portal Return URL Broken

Stripe Billing Portal opens but returns to a broken page

Clerkbeginner

Bolt Clerk Middleware Redirect Loop

The app keeps bouncing between login and dashboard

Clerkbeginner

Bolt Clerk Production Domain Not Authorized

Authentication works locally but not on the live domain

Clerkintermediate

Bolt Clerk Session Missing After Refresh

The user appears signed out after a refresh

Resendbeginner

Bolt Resend API Key Missing in Production

Emails work locally but not after deploy

Resendbeginner

Bolt Resend Emails Not Sending From Contact Form

The contact form succeeds but nobody gets an email

Resendintermediate

Bolt Resend Emails Going To Spam On Launch

Emails are sent, but they land in spam