Work with projects and files in Bolt.
Create and manage Bolt projects.
To create a new Bolt project, start a new chat: enter your prompt in the Bolt homepage.
You can view your existing projects by hovering over the left side of the screen or clicking Open sidebar
. This opens the Bolt menu. Click a previous chat to open it and continue working on it.
To edit a project title:
Open the project.
Click the menu
by the title.
Click Rename.
Enter the name.
Click the check mark button to save the change.
To delete a project, you need to both delete the chat, and deleted the associated project in StackBlitz:
Hover over the left side of the screen or click Open sidebar
to view the chat list.
Hover over the chat you want to delete.
Click Delete
.
By default, your Bolt project shows your chat and a preview of the app you’re building. If you want to directly edit your project files, you can switch from Preview to Code view. This is useful if you:
To work with files in your Bolt project, switch to Code view using the Code Preview toggle.
Open a file for editing by clicking on it. Bolt opens the file in the editor. Once you’ve made your changes, click Save or press Ctrl + s
. Bolt automatically builds your changes. Switch to Preview mode to view them.
Create a new file: right-click in the Files list, then select New file….
Delete a file: right-click on the file you want to delete, then select Delete.
You can upload individual files to Bolt. These files can either be added to the project, or used as reference by Bolt. When you upload a file, you can tell Bolt how to use it in a prompt, or rely on Bolt automatically detecting how it should be used. The maximum upload size is 9MB per file.
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
, then select the files you want to upload.
Drag and drop the file into the chatbox.
Supported file types
Images:
.jpg
.jpeg
.png
.gif
.webp
.svg
Text 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
.s
Bolt 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.
For example, you could:
Upload an image file to use as a logo on your website. Prompt:
Bolt adds this file to the project files.
Upload an image file as inspiration, to show Bolt the look and feel you want to aim for.
Bolt stores this temporarily to work with it, but doesn’t permanently add it to your project’s files.
To run the project locally, you’ll need Node.js installed.
Download and run a project on your computer:
In your project, click Export > Download. Bolt downloads a .zip
of your project.
Unzip the project.
Navigate to the project in your terminal and run:
Duplicating your project creates a fresh copy of the project in Bolt. It keeps all code and settings, apart from GitHub and Netlify integration settings.
Duplicating your project clears your chat history.
To duplicate a project, open it in Bolt, then:
If you want some information from your chat history to be available in the new project, generate a summary in the old project and upload it in the new project.
Get the AI to summarize your chat history in your old project:
Please generate a short summary of our conversation so far
..txt
or .md
file.In your new project, add the chat summary:
Enter
to upload the file and your prompt.If you decide you want to stop working with the AI, you can continue working on your project in StackBlitz’s IDE. StackBlitz is Bolt’s parent company, and accounts are automatically linked.
To open your Bolt project in the StackBlitz web IDE:
In your project, click Export > Open in StackBlitz.
Learn more about the StackBlitz IDE in StackBlitz’s documentation.
There are two ways to open StackBlitz projects in Bolt:
https://bolt.new/~/STACKBLITZ_PROJECT_SLUG_HERE
You can open any public GitHub project in Bolt by putting bolt.new
in front of the GitHub repository URL. For example: bolt.new/~/github.com/mantinedev/remix-template
.
To connect your GitHub account to Bolt and sync projects, refer to GitHub for version control.