Bolt.new Not Working? Common Errors & Fixes
The 10 Bolt.new problems users hit most often, why they happen, and the fixes that actually work — collected from user reports, forums, and official support docs.
Bolt.new Tokens Burning Fast
OngoingWebBolt spends tokens on every prompt and on its full project context, so big projects and fix loops drain allowances. Use Plan mode, specific prompts, Version History and clear context.
Bolt.new Error Loop
Workaround availableWebBolt error loops come from repeating automatic fixes. Stop clicking Attempt fix, switch to Plan mode, ask for logging and error handling, or revert in Version History.
Bolt.new Ran Out of Tokens
Workaround availableWebWhen Bolt tokens run out, free users can still edit in Code view, paid users can upgrade or reload. Free tokens reset daily and monthly; paid tokens on renewal.
Bolt.new Project Too Large to Deploy
Workaround availableWebThis error means project files exceed 100MB, usually from images or videos. Delete unused media, then move the rest to external storage and use URLs.
Bolt.new Netlify Publish Failed
Workaround availableWebIf Bolt fails to publish to Netlify, run the build, download the project and deploy it manually via Netlify drag and drop. Check status.bolt.new first.
Bolt.new Site Shows 404 After Publishing
Fixed in latest versionWebStatic hosting needs HTML output and an SPA redirect rule. Ask Bolt to build static or prerendered output and add a redirect so refreshing non-home routes works.
Bolt.new Supabase Connection Not Working
OngoingWebCheck status.bolt.new, then confirm the Supabase URL and keys match the intended project and fix RLS. Re-add environment secrets on the host if you exported.
Bolt.new GitHub Sync Not Working
Workaround availableWebReauthorize the GitHub app from the Bolt homepage. If one GitHub account is linked to two Bolt accounts, remove the link from the old account first.
Bolt.new Missing Secrets and CORS Errors
Workaround availableWebAPI calls from server functions fail when secrets are missing or CORS headers are wrong. Add secrets via the database icon and check Access-Control headers.
How to Cancel Bolt.new Subscription
OngoingWebOpen the sidebar, click your account name, Subscription, then Cancel subscription under Billing details. It takes effect next billing period; subscriptions are non-refundable per the Terms.
Problem not listed? See all Bolt.new complaints or compare Bolt.new alternatives.
// We build software. Any software.
Have an idea for an app? We'll build it.
We're a small team of developers who build custom software fast. Not just tools like Bolt.new: web and mobile apps, games, desktop software, AI tools, internal tools: whatever you have in mind. 50+ custom products built for clients so far, and we run our own products too: booking platforms, games, learning apps. See our work
- Web apps & SaaS
- Mobile apps (iOS & Android)
- Games
- Desktop software
- AI tools & automations
- Internal tools & dashboards
- Client portals & booking
- Your own version of any tool
- ✓ Free 15-min call to scope it
- ✓ Price agreed up front
- ✓ Your data, your code