App Finishers

Fix guide · updated 2026-11-11

Bolt preview not working: blank screen, stuck loading, or WebContainer error

Your preview will appear here · blank, white or gray preview · Out of memory · Building a hosted preview of your app

Your Bolt project opens, but the preview is a blank white or gray box, stays on Your preview will appear here, crashes with an out-of-memory error, or never starts. Each symptom has a different cause, and the browser you use changes how the preview works. Check status.bolt.new first: if Bolt has an incident, wait for it to clear and try again.

First: which browser are you in?

Stuck on "Your preview will appear here"

The project never started, usually because of a port conflict or an error that stops it. Asking "the preview isn't working" won't get you far. Give Bolt the exact error instead:

  1. Click the code icon (<>) at the top center to switch to Code view.
  2. At the bottom, look through the three tabs (Bolt, Publish Output, Terminal) for text in red.
  3. Copy that output, paste it into the chat, and ask Bolt to fix it: "The preview isn't loading. Here's the output from the terminal:" followed by what you copied.

The preview is blank, white or gray

Here the project starts but the page shows nothing. Work down this list:

  1. Hard refresh: Cmd+Shift+R on a Mac, Ctrl+Shift+R on Windows. Then try the project in a new tab.
  2. Ask once: "The preview is not showing, fix this." Bolt's docs say that if this works, it works on the first try. Sending the same prompt again rarely helps.
  3. Read the console. A white screen often hides a runtime error Bolt can't see. Open the browser console (Cmd+Option+J on a Mac, Ctrl+Shift+J on Windows), refresh until the white screen shows, then copy the red errors into the chat.
  4. Run a build. In Code view, open Terminal, type npm run build and press Enter. A build shows compile errors that don't appear while the preview runs.
  5. Check environment variables. Projects often show a white screen when a required variable is missing. Ask: "List every environment variable the application requires and where each value can be found." Then add them through the Secrets menu or a .env file.

If the console errors mention a Supabase URL, the project expects a database connection that isn't set up. Connect your Supabase database from the Advanced database settings. If you see Supabase URL errors while connected to a Bolt database, Bolt's docs say to contact their support.

Out of memory

In Chromium browsers the whole development environment runs on your computer, so a full machine can't start it, or it crashes mid-session. Close other tabs and apps, keep only one Bolt or StackBlitz project open, refresh, and restart your computer if it keeps happening. A browser with fewer extensions helps too.

The preview environment won't start

When WebContainers themselves fail to start:

In Safari

Still stuck after all this? Bolt's docs point to their support team, or you can send the project to us.

Sources: Bolt help center, Preview issues and Supported browsers; WebContainers.

Other Bolt app problems? See Fix a Bolt app.