Bolt.new logo
10 minute setup

How to Use Bolt.new

Go from an idea to a deployed app in 10 minutes. No install, no setup, no configuration. Just describe what you want and watch it build.

Prerequisites

  • A modern web browser (Chrome, Firefox, Safari, Edge)
  • An internet connection
  • A Bolt.new account (free tier available)
  • An idea for what you want to build

Zero install required

Bolt.new runs entirely in your browser. There is nothing to download, install, or configure on your computer. This makes it the fastest way to go from zero to deployed app.
1

Go to bolt.new

Open bolt.new in your browser. You will see a clean interface with a large text prompt area in the center.

That is it — no download page, no installation wizard, no dependency management. The entire development environment runs in your browser through WebContainers technology.

2

Sign Up

Click Sign Up in the top right. You can register with Google, GitHub, or email. Signing up saves your projects and gives you access to the free tier.

Free tier: Includes a limited number of AI tokens per day — enough to build and iterate on small to medium projects. Paid plans start at $20/mo for more tokens and faster generation.

Token strategy

Tokens in Bolt.new represent AI usage, not deployment costs. A well-crafted initial prompt uses fewer tokens than lots of small follow-ups. Front-load your description to get more out of each message.
3

Describe Your App

This is where the magic happens. Type a detailed description of what you want to build. The more specific you are, the better the result.

Here is an example of a good prompt:

Build a recipe management app with these features:
- A home page showing recipe cards in a responsive grid
- Each card shows the recipe image, name, prep time, and difficulty
- Clicking a card opens a detail page with ingredients and steps
- A form to add new recipes with image upload
- Search and filter by cuisine type
- Use React with Vite, Tailwind CSS, and React Router
- Store data in localStorage for now
- Modern, clean design with warm colors

Compare this with a bad prompt: "Make a recipe app." The second one leaves too much to interpretation and you will spend more tokens fixing the result than you saved by being brief.

4

Watch It Build

After you submit your prompt, Bolt starts generating immediately. You will see:

  • File tree — on the left, the project structure builds in real time. You can see each file as it is created.
  • Code editor — in the center, you can watch the code being written. Click any file in the tree to read it.
  • Terminal — at the bottom, Bolt installs dependencies and starts the dev server automatically.
  • Preview — on the right, a live preview updates as the app builds. You can interact with it as soon as it loads.

The whole process takes 30-90 seconds depending on app complexity. Bolt handles package installation, bundler configuration, and dev server startup automatically.

5

Preview and Test

Once Bolt finishes building, the preview panel shows your running app. Interact with it — click buttons, fill forms, navigate between pages.

Use the device toggle at the top of the preview to test different screen sizes:

  • Desktop — default view
  • Tablet — check your responsive breakpoints
  • Mobile — make sure touch targets are usable

Open in a new tab

Click the external link icon in the preview panel to open your app in a full browser tab. This gives you access to DevTools for debugging and a more realistic view of how users will see it.

Get the Vibe Coding Cheat Sheet

Best tool for every use case + pricing + pro tips. One page, zero fluff. Plus weekly updates on new tools.

6

Make Changes with Follow-Up Prompts

Your first build will not be perfect — and that is the intended workflow. Use follow-up prompts to refine:

Make the header sticky with a blur backdrop effect.
Add a loading spinner while recipes are being filtered.
Change the color scheme to use indigo instead of blue.

Each follow-up prompt has the full context of your existing app. Bolt modifies only the files that need to change, preserving everything else.

Avoid complete redesigns in follow-up prompts. Saying "Actually, rebuild the whole thing from scratch in Vue instead of React" will use a lot of tokens and may produce worse results than starting a new project.
7

Deploy

When you are happy with your app, click the Deploy button. Bolt deploys your app to a live URL — no Vercel, Netlify, or hosting configuration needed.

Deployment takes about 30 seconds. You get a URL like your-app-name.bolt.new that you can share immediately.

Custom domains

Bolt supports custom domains on paid plans. If you want your app on your own domain, you can connect it in project settings. Alternatively, export the code and deploy it yourself on any hosting platform.
8

Share Your Work

Copy your deployment URL and share it. Your app is live and accessible to anyone with the link.

You can also:

  • Export to GitHub — push your project to a repository for version control and further development in other editors.
  • Download the source — get a zip of the complete project to run locally or deploy elsewhere.
  • Continue iterating — come back to your project anytime and send more prompts to add features or fix issues.

Outgrowing Bolt?

When your project gets complex enough that you need full IDE features, export to GitHub and continue in Cursor or Windsurf. Bolt is the fastest way to get started, but IDE-based tools give you more control as projects grow.

What to Build First

Personal Landing Page

Beginner10 min

Tell Bolt: "Build a personal portfolio site with a hero section, about me, project gallery, and contact form. Use a modern gradient design." Deployed in under 5 minutes.

Expense Tracker App

Intermediate15 min

Prompt: "Build an expense tracker with categories, date filtering, a pie chart for spending breakdown, and local storage persistence." Bolt handles the full app and chart library setup.

AI-Powered Quiz App

Intermediate20 min

Prompt: "Create a trivia quiz app that generates questions using an AI API, tracks scores, shows a leaderboard, and has timed rounds." Test Bolt's ability to integrate external APIs.

Bolt.new Tips from Power Users

Front-load your prompt

The initial prompt matters most. Include the tech stack, features, pages, and design preferences upfront. It is much easier to get a good first build than to retrofit features afterward.

Use follow-up prompts for refinement

After the first build, iterate with specific prompts: "Make the header sticky," "Add a loading skeleton to the card grid," "Change the color scheme to blue and white." Each change builds on the previous state.

Check the terminal for errors

Bolt shows a terminal panel with build output. If the preview looks broken, check the terminal for error messages. You can paste the error back into the chat and Bolt will fix it.

Export to GitHub for more control

Once your app reaches a certain complexity, export the code to a GitHub repo. From there, you can continue in Cursor, Claude Code, or any other editor with full version control.

Use templates for common patterns

Bolt works great with a descriptive starting point. Mention frameworks explicitly: "Use React with Vite and Tailwind CSS" or "Use Next.js with the App Router." This avoids ambiguity.

Test on mobile early

The preview has a device toggle for mobile and tablet views. Test responsive layouts early — it is easier to prompt for mobile fixes when you can see the issue while the context is fresh.

When to Use Bolt vs an IDE

Use Bolt WhenUse an IDE When
Prototyping a new idea quicklyWorking on an existing large codebase
Building a landing page or simple appBuilding something with complex backend logic
You want zero setup overheadYou need custom dev tooling and debugging
Sharing a quick demo or proof-of-conceptWorking with a team using git branching
You are a non-developer exploring ideasYou need fine-grained version control

Built something with Bolt?

Compare Bolt against other app builders, or submit your project to the showcase.

We use cookies for analytics. Learn more