Fix: Bolt App Not Loading or Showing Blank Screen
Quick Answer
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).
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.
Related
Weekly Newsletter
Get next week's fix before you need it.
Join developers getting weekly vibe coding tips, error fixes, and tool updates.
Subscribe on Substack →