​
Tips to avoid issues

Before you start, try the following:
  • Use Chrome or a Chromium based browser.
  • Selectively disable browser extensions, especially ad blockers, to see if this resolves the issue.
  • If accessing Bolt through a VPN, try again with the VPN disabled.
  • Check if antivirus software is blocking Bolt assets, especially if you receive a 403 or 404 error.

​
White screen, grey screen, or no preview showing

Prompt Bolt: The preview is not showing, please fix this. This may resolve the issue in some but not all cases. If this doesn’t resolve the issue, repeated prompting won’t be successful. Don’t make repeated attempts, as this uses up tokens.

​
Bolt didn’t do everything you asked in your prompt

When using LLMs, break big changes into smaller pieces. Focus on one area or feature at a time, instead of trying to do many things at once.
  1. Make a change.
  2. Check if the change works.
  3. Move on to the next change.
For each change, provide a specific request. Be clear about what part of the app you’re working on, don’t assume Bolt remembers previous parts of the conversation, and try to show Bolt what you want. Prompt effectively contains more detailed guidance on writing effective prompts.

​
Prompt too long, or project exceeds total supported prompt size

You can use the following methods to reduce the size of your project to address the issue where your project exceeds the total supported prompt size.
If you’re new to AI and aren’t familiar with prompting or the limitations on how much information the AI can handle, Introduction to LLMs gives a quick intro to key concepts. You may also want to learn about Prompting effectively and Maximizing token efficiency.

​
Clean up unused files

Bolt uses a tool called Knip to perform the cleanup. You can run this when prompted by Bolt, or run it manually at any time. Before proceeding, back up your project using both of these methods:
  1. From the left-side panel, select your project. Then, click Export > Download located at the center top of the page. Export Project New Pn
  2. Now, from the drop-down, click Duplicate to create a fresh copy of your project in Bolt.
Automatic cleanup when prompted: If your Bolt project exceeds the context window (200k tokens for free accounts, 500k for paid accounts), Bolt notifies you in the chat, saying Project size exceeded. Click Remove unused files to run the cleanup. Manually run the cleanup: In the Bolt terminal run the following command: npx knip --production --fix --allow-remove-files Check the output in the terminal to see if the command ran successfully. This command removes unnecessary files from the codebase, which reduces the project size.

​
Use the .bolt/ignore file

In the .bolt/ignore file, list any files or folders that Bolt should exclude from the AI context window.
  1. In your Bolt project, switch to Code view to view your files list.
  2. Log in to your StackBlitz account.
  3. Either:
    • In the .bolt directory, click ignore to open the file in the editor.
    • If there isn’t an ignore file, right-click the .bolt directory, then click New File…. Name the file ignore.
  4. List the files you want Bolt to ignore. Provide the full path to the files, including directories. You can use * as a wildcard. For example: to ignore all files in a directory called test, write test/* in your ignore file. These files are now completely invisible to the AI, which frees up space in the context window.
"Screenshot of the Bolt UI showing an ignore file"
Hiding files from the AI can have unintended consequences, as the AI is no longer aware of your entire project. This approach is powerful, but is only recommended for advanced users who can make informed decisions about what can safely be excluded, and can understand and resolve issues that may arise from this approach.

​
Split the project

Break a large app into smaller chunks, and glue it all back together outside of Bolt later. For example, separating the backend and frontend into different projects is a common developer pattern. Be careful doing this if you don’t have experience as a developer.

​
AI stuck or unresponsive

If the AI seems stuck or unresponsive to commands, resetting the AI context window can help. To do this, open your project and duplicate it, then work in the new copy of the project. If you want to keep some information from the chat, create a summary of the old chat. Get the AI to summarize your chat history:
  1. Switch to Discussion Mode: in the Bolt prompt box in your project, click Toggle Chat icons used as button to toggle between build mode and discussion mode
  2. Prompt the AI: Please generate a short summary of our conversation so far.
  3. Check that the AI response is accurate and contains everything you need.
  4. Copy the response out of Bolt and save it as a .txt or .md file.
Then, reset the context window:
  1. Open the menu Menu icon next to the project name.
  2. Click Duplicate.
  3. If you have integrations active in the project, Bolt displays a dialog that confirms which integration settings it will copy. Click Duplicate in the dialog to continue.
  4. Bolt creates a new copy of the project, with an empty chat history.
In your new project, add the chat summary:
  1. Switch to Discussion Mode: in the Bolt prompt box in your project, click Toggle Chat icons used as button to toggle between build mode and discussion mode
  2. Click Upload files Upload file icon
  3. Provide a prompt such as: 
    The attached file is a summary of previous discussion about this project.
Please use it when working on future changes.
  4. Press Enter to upload the file and your prompt.

​
Chat history or project disappears

To continue working on a project in a new browser:
  1. Log in to StackBlitz.com with your Bolt account.
  2. Open the Collections tab.
  3. Open the Bolt collection. You should see all of your projects there.
  4. Click the project, then use the Open in bolt.new | AI button to continue working on it in Bolt.
If your project is missing, this is a serious bug that requires Bolt’s help to investigate. Contact the support team at [email protected].

​
Out of memory (OOM)

This error occurs when there isn’t enough memory available to run the . To free up system memory, close unnecessary applications and browser tabs.

​
WebContainer startup error

Bolt relies on WebContainers, a browser-based runtime from StackBlitz that enables a full-stack development environment in the browser. If you encounter a WebContainer error, try the following:
  • Use Chrome or a Chromium-based browser.
  • Selectively disable browser extensions, especially ad blockers, to see if this resolves the issue.
  • If accessing Bolt through a VPN, try again with the VPN disabled.