Bolt.new Site Shows 404 After Publishing

How to fix it

// try these in order, the most common fix is first

1. FIX 1Build as static HTML

   Copy steps
   1. 01Ask Bolt to use SPA mode or prerendering
   2. 02Publish again
   Did this fix it? Yes No

2. FIX 2Add a redirect rule

   Copy steps
   1. 01Ask Bolt to add /* /index.html 200 in a _redirects file (or netlify.toml)
   2. 02Publish, then Update
   3. 03Refresh a non-home page to confirm
   Did this fix it? Yes No

3. FIX 3Build output directory not found

   Copy steps
   1. 01Paste the error in chat and ask Bolt to fix the build
   2. 02Publish again; contact support if it persists
   Did this fix it? Yes No

Symptoms

Home page works but other routes 404, or the site shows only 404 pages.

Why it happens

• C-01Server-rendered framework with no HTML output
• C-02Single-page app routes missing a redirect rule
• C-03No build output directory

// this guide also covers

• bolt.new 404 after publish
• bolt.new page not found refresh
• bolt.new no build output directory

The same problem in other apps

All not loading, error messages & connection guides →

• Lovable Stuck in an Error Loop (Lovable)
• Replit Workspace Not Loading (Replit)
• Cursor High Load Error (ERROR_RESOURCE_EXHAUSTED) (Cursor)
• Bubble Workload Units Running Out Too Fast (Bubble)
• GitHub Copilot Proxy and Certificate Errors (GitHub Copilot)

Other Bolt.new errors

• Bolt.new Tokens Burning Fast
• Bolt.new Error Loop
• Bolt.new Ran Out of Tokens
• Bolt.new Project Too Large to Deploy
• Bolt.new Netlify Publish Failed
• Bolt.new Supabase Connection Not Working
• Bolt.new GitHub Sync Not Working
• Bolt.new Missing Secrets and CORS Errors