Fix: Bolt App Not Loading or Showing Blank Screen
Quick Answer
How do I fix "App not loading" in Bolt?
Refresh the page and try again. Bolt uses WebContainers which can occasionally get stuck. If that doesn't work, try in a different browser (Chrome works best).
Fix signals
- What this answers
- How to fix app not loading in Bolt.
- Fastest move
- Refresh and retry
- Use this page if
- WebContainer shows loading spinner forever
If this keeps happening
Open the next decision if the same bug class keeps coming back
Use these when the troubleshooting page named the failure, but the higher-leverage move is changing the stack choice, support layer, or production workflow.
Bolt reviews
Open this when the prototype came fast but the rebuild cost is starting to show up in auth, deploy, or state problems.
Open this next →
Bolt vs v0
Open this when the real decision is whether you still need a browser-first prototype tool or a stronger frontend base.
Open this next →
Fillout vs Typeform
Open this when forms, onboarding, intake, or checkout are the next workflow layer breaking after the app shell is already in place.
Open this next →
Tool picker
Use this when the fix helped name the problem, but the bigger question is still which tool or workflow should own the next version of the app.
Open this next →
Firecrawl review
Use this when the next decision is getting broader than one bug and now includes data-fetching, agent, or infra choices.
Open this next →
Quick Fix Summary
| Issue | App not loading |
| Fastest fix | Refresh and retry |
| Use this page if | WebContainer shows loading spinner forever |
Symptoms
- !WebContainer shows loading spinner forever
- !Blank white screen after generation
- !Console shows JavaScript runtime errors
- !App loads partially then crashes
Step-by-Step Fix
Refresh and retry
WebContainers can get into stuck states. Hard refresh (Ctrl+Shift+R) the page and regenerate your app.
Check browser compatibility
Bolt works best in Chrome. Safari and Firefox may have WebContainer issues. Switch to Chrome if you're having problems.
Simplify your prompt
Complex prompts can generate code with runtime errors. Start with a simpler version and add features incrementally.
Check the console for errors
Open browser DevTools (F12) > Console to see specific JavaScript errors. These can help identify what's failing.
Clear browser data
Clear your browser cache and cookies for bolt.new. WebContainer state can become corrupted.
Frequently Asked Questions
Bolt works best in Chrome. WebContainer support is limited in Safari and Firefox. Use Chrome for the most reliable experience.