Interacting with Bolt

This page covers common tasks in Bolt and highlights key elements of the interface, often referred to as the user interface (UI).

​

View a list of your projects

Once you’re logged in to Bolt, you can see all your projects in one place, making it easy to switch between them. To view your projects, follow these steps: Once you’re logged in to Bolt, you can see all your projects in one place, making it easy to switch between them. To view your projects, follow these steps:

1. Log in to Bolt.
2. Go to the Bolt homepage.
3. Hover over the left side of the screen to open the menu.
4. View a list of your projects under Your Chats.
5. Click a project name to open that project in Bolt.

​

Switch between Bolt agents

You can switch between agents in two places: from the Bolt homepage when starting a build, or inside a project while working. Resetting the chat history is intentional and helps prevent confusion between agents. Your new agent will still have full access to your project and files. Any general or ongoing instructions you want to preserve should be added to Project Knowledge. On the homepage When you’re on the Bolt homepage about to start a new chat, you can use the drop-down agent selector in the bottom of the chatbox to select your preferred agent. In a project When working inside a project, follow these steps to switch agents:

1. In the bottom-left corner of the chatbox, click the plus icon to open the menu.
2. Hover over the agent in use to view alternatives.
3. Click the name of the agent you want to select.
4. Confirm your choice.

​

How to use Plan and Discussion Modes

The Plan and Discussion Mode menu options are available in the same location in the chatbox menu. Which one appears will depend on which agent you are using. When using Claude Agent, you’ll see Plan Mode. When using v1 Agent (legacy), you’ll see Discussion Mode.

​

Use Plan Mode on the Bolt homepage

You can begin your Bolt project in Plan Mode right from the first prompt. This lets you create and refine a plan through back-and-forth discussion before executing a build, helping you avoid unwanted changes and use fewer tokens overall. Simply click Plan before submitting your prompt to generate a plan for your build. Plan Mode highlights blue when active. Click it again to turn it off and return to Build mode.

​

Use Plan Mode in a Bolt project

Follow the steps below to switch to Plan Mode while working in a Bolt project:

1. Open a project working with Claude Agent.
2. In the bottom-right corner of the chatbox, click Plan.
3. Enter your question or prompt, and read the response. You can then either:
   • Continue the discussion.
   • Use one of the quick action buttons to implement the suggestion.

​

Use Discussion Mode in a Bolt project

Follow the steps below to switch to Discussion Mode while working in a Bolt project:

1. Open a project working with the v1 Agent (legacy).
2. In the bottom-right corner of the chatbox, click Discuss.
3. Enter your question or prompt, and read the response. You can then either:
   • Continue the discussion.
   • Use one of the quick action buttons to implement the suggestion.

​

Search the Help Center from the chatbox

You can search the entire Bolt Help Center without leaving your project by following these steps:

1. In the bottom-left corner of the chatbox, click the plus icon, then click Search Help Center.
2. Enter your keywords, and a list of articles will appear.
3. Click any topic to open it in a new tab.

​

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 bottom-left corner of the chatbox, click the plus icon, then click Attach a file.
• 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.

​

Supported file types

Open the accordion menu below to view a list of supported file types.

Supported file types

Images: .jpg .jpeg .png .gif .webp .svgText files: .pdf .txt .doc .docx .py .ipynb .js .mjs .cjs .jsx .html .css .scss .sass .ts .tsx .java .cs .php .c .cc .cpp .cxx .h .hh .hpp .rs .swift .go .rb .kt .kts .scala .sh .bash .zsh .bat .csv .log .ini .cfg .config .json .yaml .yml .toml .lua .sql .md .tex .latex .asm .ino .sBolt can upload file types for a wide range of programming languages. Bolt only builds JavaScript-based applications (see Supported technologies), but you can upload files from other programming languages to guide Bolt, or ask Bolt to convert them into JavaScript.

​

Personal settings

You can personalize the Bolt interface through your Personal settings. This includes:

• Switching between light and dark themes using the theme dropdown
• Turning sound notifications on or off when Bolt finishes responding
• Showing or hiding token usage in chat
• Enabling or disabling line wrapping for long lines of code in the editor

To update your personal settings, follow these steps:

1. Log in to Bolt and open the Bolt homepage.
2. Hover over the left side of the screen, then click Settings.
3. Set your desired personal settings using the drop-down theme menu and the toggle switches, as shown in the example screenshot below:

​

Clear context

You can clear the context in Bolt by entering the /clear command in your chatbox, then clicking Clear context in the Results section above. Clearing the context resets Bolt’s understanding of your project. When you do this, Bolt forgets:

• Your recent conversation history
• Its understanding of how your codebase has changed over time

Bolt will still have access to your codebase and files, but it will evaluate them as if it were seeing them for the first time. If you’re sure your previous messages are no longer relevant, clearing the context can be useful. It removes unnecessary information, or “noise,” that might otherwise confuse the language model that powers 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. In the bottom-left corner of the chatbox, click the plus icon, then click Enhance prompt.
3. Bolt generates a recommended prompt, which you can then edit.

​

Comparing original and enhanced prompt results

The image below compares two websites created with the same prompt. The version on the right was built with a simple prompt, while the version on the left was enhanced to produce a more engaging homepage and additional pages.

​

Prompt library

The prompt library is a collection of prompts. It contains prompts provided by Bolt and custom prompts you’ve created and saved. 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 bottom-left corner of the chatbox, click the plus icon, then click Open Prompt Library. 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, start typing /create prompt. Click the blue Create prompt text that appears. 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. In the bottom-left corner of the chatbox, click the plus icon, then click Open Prompt Library.
2. Locate the prompt you want to manage and click on it.
3. Click the three-dot menu.
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.

​

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. Open a Bolt project.
2. Click the code icon (<>) in the top center of your screen to switch to Code view.
3. Right-click the files you want to focus on.
4. Click Target file.

​

Exclude specific files or directories

1. Open a Bolt project.
2. Click the code icon (<>) in the top center of your screen to switch to Code view.
3. Right-click the files or directories you want to exclude.
4. Click Lock file (single file) or Lock all (directory).

​

Focus on a specific code section

1. Open a Bolt project.
2. Click the code icon (<>) in the top center of your screen to switch to Code view.
3. Highlight the code you want to discuss or change.
4. Click the Ask Bolt button (if the button doesn’t appear immediately, try right-clicking). Bolt links the selection in the prompt box.
5. Enter your question or request.

​

Focus on a specific UI element

1. In Preview view, click the Inspector icon in the top center of your screen.
2. Click the element you want to focus on.
3. Bolt links the selection in the prompt box.
4. Enter your prompt.

​

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 a cleanup. You can run this when prompted by Bolt, or run it manually at any time. Before proceeding, back up your project using one or both of these methods:

• In the top left of your screen, click the project title, then click Export > Download, or
• In the top left of your screen, click the project title, then click Duplicate.

Automatic cleanup when prompted If your Bolt project exceeds the context window, you’ll see a message in chat: Project size exceeded. The context window is the maximum amount of information Bolt can process at once. Paid plans offer larger windows, allowing bigger projects before reaching this limit. 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.

Open the Bolt terminal

1. Log in to your project.
2. Click the code icon (<>) in the top center of your screen to switch to Code view.
3. Scroll down to the bottom, then click Terminal.