Skip to main content

Documentation Index

Fetch the complete documentation index at: https://support.bolt.new/llms.txt

Use this file to discover all available pages before exploring further.

After you create a project in Bolt, you can view, rename, duplicate, download, or delete it at any time.

​
View a list of your projects

When you’re logged in to Bolt, you can access your project list from the homepage or from inside an existing project.

​
From the homepage menu

The Bolt homepage with the Projects, Created by you, Starred, Recently viewed, and Shared with you options highlighted
  1. Log in to Bolt.
  2. On the Bolt homepage, in the sidebar, click how you want to view your projects:
    • Projects: View all projects, including your own projects and projects others shared with you.
    • Created by you: View only projects you created.
    • Starred: View only projects you starred.
    • Recently viewed: View projects you opened recently. These include your own project and those shared with you.
    • Shared with you: View projects others have shared with you. What you can do in shared projects depends on the role the project owner assigned you.
  3. Click a project name to open that project in Bolt.

​
From the projects dashboard

The projects dashboard showing several projects favorited and the context menu open with the open, rename, transfer, and delete options showing.
  1. Log in to Bolt.
  2. On the Bolt homepage, in the sidebar, click Projects.
You can see a list of your projects and those that other team members or collaborators have shared with you.
Use the search bar at the top to find a specific project.

​
From inside a project

Inside a Bolt project, you can switch to another recent project. Projects are sorted with the newest first.
The recent project selector in the Bolt title name menu.
  1. Open a project in Bolt.
  2. Click the project title.
  3. Hover over Open recent project.
  4. Click the project you want to switch to.

​
Create a new project

To create a new Bolt project, submit a new prompt on the Bolt homepage. Bolt automatically adds it to your project list and generates a title for it.

​
Rename a project

The Projects page showing the project menu with the Rename option highlighted.
  1. On the Bolt homepage, click Projects.
  2. On the projects dashboard, click the three dots menu under the project.
  3. Click Rename.
  4. Type a new name for your project, then click Rename again.

​
Download a project

You can download your project as a zip file to work on it outside of Bolt, using your own code editor.
To run the project on your computer, you’ll need Node.js installed first. Node.js is a free tool that lets you run web applications locally.
The export and download option in Bolt
  1. In Bolt, open your project.
  2. In the top left of your screen, click the project title, then click Export > Download.
  3. Unzip the downloaded file.
  4. Open your terminal, navigate to the project folder, and run the following command to install dependencies and start the app:
   npm install && npm run dev

​
Transfer a project

You can transfer a project to another workspace you own or to a different user entirely. Unlike duplicating, transferring moves the project out of the original account, so you won’t have access to it in both places. You can’t transfer a project that has an active GitHub or Supabase integration or a custom domain. Remove these before transferring. After transferring:
  • You can reconnect your Supabase integration or domain, or the new project owner can connect their own.
  • You can connect a new GitHub integration, or the new project owner can. GitHub doesn’t support connecting an existing repository to an existing project, but you can create a new repository from a Bolt project.
If your site uses a custom domain you purchased through Bolt, you can’t reconnect the custom domain until after it expires. We don’t recommend transferring a project that uses a Bolt-purchased domain.

​
Transfer to a workspace

Use this option to move a project between your own workspaces. For example, from your personal account to a team account.
  1. In your project, in the top menu, click the project name.
  2. Click Transfer to.
  3. In the Transfer project dialog, select the To a workspace tab.
  4. From the Workspace dropdown, select the workspace where you want to transfer the project.
  5. Click Continue, then click Confirm transfer.

​
Transfer to a user

Use this option to transfer ownership of a project to another Bolt user. After the recipient accepts the transfer, you won’t be able to access the project or make any further edits.
  1. In your project, in the top menu, click the project name.
  2. Click Transfer to.
  3. In the Transfer project dialog, select the To a user tab.
  4. Enter the recipient’s email address.
  5. Click Continue, then click Confirm transfer.
The recipient receives an email invitation. After they accept, ownership transfers to their account.

​
Duplicate a project

Duplicating a project creates a fresh copy in Bolt with all of your code and settings intact, except for GitHub and Netlify integration settings.

​
Database duplication

If your project uses a Bolt database, the duplicated project copies the database structure (the tables and columns you’ve set up) but not the data itself. If your project uses a Supabase database, you can either create a new Bolt database (which copies the structure only) or connect the duplicated project to the same Supabase project as the original. Deselect Use Bolt database if you want to maintain your existing Supabase connection.
The database duplication options when duplicating a Supabase project.
If you want to keep your data in the duplicated project, stay connected to your Supabase database. Avoid making changes to the same database from both projects — after duplicating, manage database changes from one project only.

​
Duplicate your own project

Duplicating a project clears your chat history.
The Duplicate project option in Bolt
  1. Log in to your project.
  2. In the top left of your screen, click the project title, then 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.
If you want information from your chat history available in the new project, generate a summary before duplicating and upload it afterward. Generate a summary in your original project:
  1. In the bottom-left corner of the chatbox, click the plus icon, then click Discussion Mode.
  2. Enter the following prompt: 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.
Upload the summary in your new project:
  1. In the bottom-left corner of the chatbox, click the plus icon, then click Discussion Mode.
  2. Click the plus icon again, then click Attach file.
  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.

​
Duplicate a shared project to your account

You can duplicate a project, then transfer the duplicate to your own account. The original project remains in the shared account, and the duplicate is moved to your personal account. Keep in mind that database information is not copied over. If the original project used a Bolt database, you can create a new one when duplicating, but it won’t include the previous schema or data. If your project was connected to a Supabase database, you can reconnect to it from the new account. Similarly, if the original project used a custom domain, it stays attached to that project. To use it with the duplicated project, you have to disconnect the domain from the original project, then connect it to the duplicate after transferring it. To duplicate a project between accounts:
  1. Log in to your project.
  2. In the top left of your screen, click the project name, then click Duplicate. If you have integrations active in the project, Bolt displays a dialog that confirms which integration settings it will copy.
  3. Click Duplicate in the dialog to continue.
  4. Bolt creates a new copy of the project, with an empty chat history.
  5. Click the project name again, then click Transfer to.
  6. Select the user or workspace you want to own the duplicated project.
  7. Click Continue, then click Confirm transfer.
  8. If needed, reconnect your database or custom domain:

​
Continue in StackBlitz

If you decide you want to stop working via the Bolt chatbox interface, you can continue working on your project in StackBlitz’s IDE. StackBlitz is Bolt’s parent company, and accounts are automatically linked. If you’d rather work in a traditional code editor instead of Bolt’s chat interface, you can open your project in StackBlitz. StackBlitz is Bolt’s parent company, and your accounts are automatically linked.
  1. In Bolt, open your project.
  2. In the top left of your screen, click the project title, then click Export > Open in StackBlitz.
Learn more about the StackBlitz editor in StackBlitz’s documentation.

​
Open a StackBlitz project in Bolt

To open a StackBlitz project in Bolt, do one of the following:
  • Click Open in Bolt in the upper-left corner of any StackBlitz project.
  • Enter the following URL in your browser, replacing STACKBLITZ_PROJECT_SLUG_HERE with your project’s ID (visible in the StackBlitz URL): https://bolt.new/~/STACKBLITZ_PROJECT_SLUG_HERE

​
Open a public GitHub repository in Bolt

You can open any public GitHub repository in Bolt by adding bolt.new to the front of the GitHub URL. For example: bolt.new/~/github.com/mantinedev/remix-template. To connect your GitHub account to Bolt and sync projects, see GitHub for version control.

​
Delete a project

To fully delete a project, you need to delete both the chat in Bolt and the associated project in StackBlitz (the platform that runs Bolt in the background).

​
Delete a project chat

The Projects page showing the project menu with the Delete option highlighted.
  1. On the Bolt homepage, click Projects.
  2. On the projects dashboard, click the three dots menu under the project.
  3. Click Delete, then click Delete again to confirm.

​
Delete a project in StackBlitz

  1. Log in to your StackBlitz account.
  2. Click Collections.
  3. Click Bolt collection.
  4. Click the menu icon for the project you want to delete.
  5. Click Delete project.