This guide covers common tasks when interacting with Bolt. You should also review the Best practices guides, for tips on getting the most out of Bolt.

Automatically improve your prompts

Bolt helps you craft better prompts, which are key to building successfully.
  1. Write your prompt in the chatbox.
  2. Click Enhance prompt Star icon. Bolt generates a recommended prompt, which you can then edit.
"Gif showing a short prompt being copied into Bolt, the user clicks enhance prompt, and Bolt converts it to a more detailed prompt"

Prompt library

The prompt library is a collection of prompts. It contains prompts provided by Bolt and custom prompts you created. Instead of typing out the same prompt over and over again that you like to use in your projects, you can simply choose it from the list. Using a pre-written prompt saves time and allows you to save and reuse good prompts. You can access the prompt library either in the chatbox on the homepage or in your projects.

Use an existing prompt

In the chatbox, click Open prompt library. Bolt Open Prompt Library Use a mouse or keyboard ↑ and ↓ to browse through the list of available prompts. Prompts are organized into categories like “SEO” and “Usability”. There are also two special categories: “Favorites” and “Commands”. When you select a prompt, you will see a preview of the prompt. To use the selected prompt, click it again, or press Enter. This will populate the chatbox with the content of the prompt. You can then use it as is or edit it like any other prompt that you would write on your own. If you already know the prompt that you want to use, start typing it and Bolt will automatically show all prompts with matching names. e.g., typing “dar” will bring up Bolt’s dark mode implementation prompt. Click Use prompt or press Enter. Bolt adds the prompt to the chatbox.

Add a prompt

In the chatbox, either start typing ‘’/create prompt’’ or click the Open prompt library button.
You can edit and delete any prompts that you create. You cannot edit and delete built-in prompts provided by Bolt.
Click Create prompt. Add New Prompt Fill in the following:
  • Choose a category, or create a new one from the dropdown.
  • Select an icon.
  • Name your prompt.
  • Write the prompt in the prompt field.
  • Click Create prompt to save it.

Manage a prompt

You can favorite any prompt (both built-in and custom). This adds it to the top of the list.
  1. Click Open prompt library in the chatbox.
  2. Locate the prompt you want to manage and click on it.
  3. Click the three-dot menu. Manage Prompt
  4. Choose the action:
    • Toggle favorite: Adds the prompt to favorites, and it is now at the top of the list. Alternatively, click the star icon next to the prompt to add it to your favorites. Repeat the same if you want to remove a certain prompt from favorites.
    • Edit (custom prompts only): Opens the prompt for you to make changes.
    • Delete (custom prompts only): Deletes the prompt from the library.

Change the mode

When talking with Bolt in your project, you can switch between two modes:
  • Build Mode: Bolt takes your prompt and makes changes to your files immediately.
  • Discussion Mode: talk with Bolt, without it making changes. This is useful if you want to discuss ideas, plan work, or troubleshoot, without using a large amount of tokens. Refer to Discussion mode for more information on this feature.
To switch between modes: in the Bolt prompt box in your project, click Toggle Chat icons used as button to toggle between build mode and discussion mode to toggle between Discussion Mode and Build Mode.

Add files to inform Bolt

You can give Bolt extra information by uploading files. You can upload files when creating a new project on the Bolt homepage, or in an existing project in your chat. To upload a file, either:
  • In the chatbox, click Upload files Upload file icon , then select the files you want to upload.
  • Drag and drop the file into the chatbox.
For example, you can:
  • Add an image as an example of the look and feel you want.
  • Work on defining your product features with your team in a separate document, then upload it to Bolt.

Guide Bolt’s focus

You’ll get more accurate results if you’re explicit about what Bolt should and shouldn’t change.

Limit Bolt to specific files

  1. Right-click the files you want to focus on in the Bolt Code editor.
  2. Select Target file.

Exclude specific files or directories

  1. Right-click the files or directories you want to exclude in the Bolt Code editor.
  2. Select Lock file (single file) or Lock all (directory).

Focus on a specific code section

  1. Make sure you’re in Code view.
  2. Highlight the code you want to discuss or change.
  3. Click the Ask Bolt button (if the button doesn’t appear immediately, try right-clicking). Bolt links the selection in the prompt box.
  4. Enter your question or request.

Focus on a specific UI element

  1. In Preview view, click Inspector Inspector icon.
  2. Click the element you want to focus on. Bolt links the selection in the prompt box.
  3. Enter your question or request.

Clean up unused files

Cleaning up unused files reduces the size of the context window, which means you use fewer tokens. 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.