Bolt.new Preview Blank Screen or "Your Preview Will Appear Here"

Share
Workaround available Browser Updated November 14, 2026How we research

Quick answer

A blank or stuck Bolt preview is usually a runtime error, missing environment variable or startup failure. Hard refresh, then check the Terminal.

Most likely fix: Refresh and retry

How to fix it

Try these in order — the most common fix is first.

  1. 1. Refresh and retry

    1. Hard refresh with Cmd+Shift+R (Mac) or Ctrl+Shift+R (Windows)
    2. Open the project in a new tab
    Did this fix it?
  2. 2. Read the errors

    1. In Code view, open Terminal and look for red error text
    2. Open the console, reload, and paste errors into Bolt
    3. Run npm run build in the Terminal, then click the eye icon to return to the preview
    Did this fix it?
  3. 3. Fix the WebContainer startup

    1. Use Chrome or another Chromium browser and clear the cache
    2. Disable extensions (especially ad blockers) and any VPN
    3. Try Chrome Guest mode
    Did this fix it?

Symptoms

Preview shows a blank, white or gray screen, or stays on "Your preview will appear here".

Why it happens

  • Runtime errors or missing dependencies
  • Missing environment variables
  • WebContainer startup failure from extensions, VPN or browser

This guide also covers

  • bolt.new preview not working
  • bolt.new blank screen
  • bolt your preview will appear here

Still not working?

If StackBlitz keeps failing, you're not alone. See every StackBlitz problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us
Fixed it? Share this guide

The same problem in other apps

All crashes, freezes & blank screens guides →

Other StackBlitz errors

All 11 StackBlitz errors and fixes →