Bolt.new logo
10 minute setup

Bolt.new Setup: How to Use Bolt

Go from an idea to a published app in 10 minutes. Nothing to install, nothing to configure. This walkthrough covers the whole flow, checked against Bolt's official docs and live pricing in August 2026.

Open Bolt.new Free

Quick Answer: Bolt.new setup

There is nothing to install. Open bolt.new in a desktop browser, sign in with Google, GitHub, or email, type a description of the app you want, and Bolt builds and runs it in the browser. One click on Publish puts it on a free .bolt.host URL. The free plan includes 300K AI tokens a day (1M a month); Pro is $25 a month as of August 20, 2026.

Prerequisites

  • A modern desktop browser (Chrome, Firefox, Safari, Edge)
  • An internet connection
  • A Bolt.new account (free, sign in with Google, GitHub, or email)
  • An idea for what you want to build

Zero install required

Bolt.new runs entirely in your browser through WebContainers, including the dev server and terminal. There is nothing to download, install, or configure on your computer, which makes it the fastest route from zero to a published app.
1

Go to bolt.new

Open bolt.new in your browser. You get a clean screen with a large prompt box in the center and a Build Now button. That is the entire product surface until you type something.

No download page, no installation wizard, no dependency management. The full development environment, dev server included, runs inside the browser tab.

2

Sign Up (Free)

Sign in with Google, GitHub, or email. Signing up saves your projects and activates the free tier. What the free plan actually includes, per the live pricing data we track (verified August 20, 2026):

  • 300K AI tokens per day, capped at 1M per month
  • Public and private projects
  • Website hosting on a free .bolt.host address
  • Databases included, 10MB file uploads, Bolt branding on published sites

Pro is $25/mo: 10M tokens per month with no daily limit, unused tokens roll over for one month, custom domains, no branding, 100MB uploads. Teams is $30 per member. Full breakdown on our Bolt pricing page.

Token strategy

Tokens are AI usage, not hosting costs. One well-specified initial prompt uses fewer tokens than a dozen small corrections, so front-load your description. The daily cap resets every day; a burned afternoon is not a burned month.
3

Describe Your App

Type a detailed description of what you want and press Build Now. The more specific you are, the better the first build. 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 that with "Make a recipe app." The short version leaves everything to interpretation, and you will spend more tokens correcting the result than you saved by typing less.

Web app or mobile app?

Bolt builds full-stack JavaScript web apps, and mobile apps through its Expo integration. If you want mobile, say so in the first prompt so it starts from the right foundation.
4

Watch It Build

Bolt starts generating immediately. You will see four things working at once:

  • File tree: on the left, the project structure builds in real time.
  • Code editor: in the center. Click any file to read what was written.
  • Terminal: at the bottom, dependencies install and the dev server starts automatically.
  • Preview: on the right, a live preview you can click around as soon as it loads.

A first build typically lands in one to a few minutes depending on complexity. Bolt handles package installation, bundler configuration, and server startup on its own.

5

Preview and Test

Interact with the preview like a user would: click buttons, fill forms, navigate between pages. Use the device toggle at the top of the preview to check tablet and mobile layouts before you invest in more features.

Open in a new tab

The external link icon in the preview panel opens your app in a full browser tab. That gives you DevTools for debugging and a realistic view of what users will see.

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

Refine with Follow-Up Prompts

Your first build will not be perfect, and that is the intended workflow. Iterate with specific follow-ups:

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 has full context of your existing app, and Bolt modifies only the files that need to change. When you want to discuss direction rather than change code, switch to Plan mode: it answers and designs without editing the project, and costs fewer tokens than Build mode.

Avoid full redesigns in follow-up prompts. "Rebuild the whole thing in Vue instead of React" burns a pile of tokens and usually produces a worse result than starting a fresh project with a better first prompt.
7

Publish

When you are happy with the app, press Publish. Bolt hosts the app itself and gives you a live address on a free .bolt.host domain. Publishing is available on the free plan; no Netlify, Vercel, or hosting account is involved.

Publishing takes well under a minute, and the URL is shareable immediately. Remember it is a snapshot: later edits stay in the editor until you publish again.

Custom domains

Custom domains are a Pro feature. Connect your own domain in project settings on Pro, or export the code and host it anywhere you like. If you published through Bolt's old Netlify integration before August 2025, those projects can be migrated to Bolt's native hosting.
8

Share, Export, Keep Building

Your app is live and the code is yours, for any purpose including commercial use. From here you can:

  • Export to GitHub: push the 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.
  • Keep iterating: reopen the project anytime and prompt for new features or fixes.

Outgrowing Bolt?

When the project needs real IDE features, export to GitHub and continue in Cursor or Claude Code. Bolt is the fastest starting line; IDE tools give you more control as the codebase grows. Our Cursor setup guide picks up exactly where this one ends.

The 3 Settings That Actually Matter

1. Plan mode vs Build mode

The toggle that controls your token burn. Build mode spends tokens on every code update; Plan mode discusses without editing and costs less. Think in Plan, execute in Build. This single habit stretches the free tier further than anything else.

2. Agent selection

Bolt lets you pick the agent that powers your builds. The standard agent handles most work; save the heavier max option for genuinely complex tasks, because it costs more tokens for the same prompt. Matching agent to task is free money.

3. Connectors and context

Connectors add external services into Bolt's context, and everything in context costs tokens on every prompt. Bolt's own efficiency docs say it plainly: turn on connectors only when you need them, remove unused files, and clear the context when Bolt seems confused about the state of your project.

Troubleshooting: Where Builds Get Stuck

The preview is blank or shows an error page
Check the terminal panel first. Bolt runs a real dev server in your browser, and when the preview breaks there is almost always a build error sitting in the terminal output. Copy the error message, paste it into the chat, and ask Bolt to fix it. That loop resolves the large majority of broken previews.
Ran out of tokens in the middle of a build
The free plan caps you at 300K tokens a day and 1M a month (as of August 20, 2026). A big first prompt plus a few heavy revisions can hit the daily cap in one session. Your options: wait for the daily reset, switch to Plan mode for questions so you stop burning Build-mode tokens, or upgrade to Pro ($25/mo, 10M tokens, no daily limit).
Bolt keeps rewriting things you did not ask it to touch
Scope your prompts. Tell it exactly which file or feature to change: "Only modify the Header component" beats "fix the header." If it still thrashes, clear the context (Bolt's own docs recommend this) so it re-reads the project fresh instead of acting on a stale understanding.
Each follow-up prompt burns more tokens than expected
Prompting costs tokens, clicking buttons does not. Use the on-screen Publish and version history controls instead of asking Bolt to do those things in chat. Turn off connectors you are not using, remove unused files, and put questions through Plan mode, which does not modify the project and costs less.
Published the app but the live URL shows an old version
Publishing is a snapshot, not a live sync. Changes you make after publishing stay in the editor until you press Publish again. If the URL still looks stale after republishing, hard-refresh the page; the old version can sit in your browser cache.
The app works in preview but breaks after publishing
The usual causes are API keys and browser-only storage. Anything that worked because the preview session had your login or local state needs real configuration on the published site. Check environment variables and any service connections in the project settings before assuming the code is wrong.

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." Published 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.

Plan mode for thinking, Build mode for changes

Plan mode discusses your project without editing it and uses fewer tokens. Work out the approach there, then switch to Build mode to execute. Questions asked in Build mode are the most expensive way to think.

Check the terminal for errors

Bolt shows a terminal panel with build output. If the preview looks broken, check the terminal for error messages. 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. You own the code.

Name your stack explicitly

Mention frameworks in the prompt: "Use React with Vite and Tailwind CSS" or "Use Next.js with the App Router." Bolt builds JavaScript-based stacks, and being explicit avoids a framework you did not want.

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 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

Ready to build with Bolt?

For the fuller picture, read our Bolt review or put it head to head with Lovable in the live duel.

Learn More About Bolt

Bolt.new Setup FAQ

Is Bolt.new free to use?
Yes, with a token allowance. The free plan includes 300K AI tokens per day, capped at 1M per month (checked against the live Bolt pricing page on August 20, 2026), plus hosting on a free .bolt.host address. That is enough to build and publish a small first app. Pro is $25 per month for 10M tokens with no daily limit, custom domains, and no Bolt branding.
Do I need to install anything to use Bolt.new?
No. Bolt runs entirely in your browser, including the dev server and terminal, through WebContainers. There is no download, no local Node.js install, and no configuration. A desktop browser is strongly recommended over a phone because you will want the editor, terminal, and preview visible together.
How do I set up Bolt.new?
There is no setup in the traditional sense: open bolt.new, sign in with Google, GitHub, or email, and type a description of what you want to build. Your first working app is typically live in the preview within a couple of minutes of your first prompt.
What is the difference between Plan mode and Build mode?
Build mode makes changes to your project and spends tokens on every code update. Plan mode discusses, explains, and designs without touching files, so it uses fewer tokens. The efficient workflow is to think in Plan mode and execute in Build mode.
How do I publish an app from Bolt.new?
Press the Publish button. Bolt hosts the app itself and gives every user, free or paid, a live .bolt.host URL, with no separate hosting account needed. Custom domains require the Pro plan. Bolt used Netlify for hosting historically, but projects now publish to Bolt's own hosting.
What can I actually build with Bolt.new?
Full-stack JavaScript web apps across mainstream frameworks, with databases and hosting handled inside the project, plus mobile apps through the Expo integration. You own the code you generate and can use it commercially.
What happens when I run out of tokens?
On the free plan you wait for the daily reset (300K/day) or the monthly reset (1M/month), or upgrade. Pro includes 10M tokens a month with no daily limit, and unused tokens from a paid subscription roll over for one additional month.
Can I export my code out of Bolt.new?
Yes. Export to a GitHub repository or download the project as a zip and run it locally. This is the standard path once an app outgrows the browser: export, then continue in an IDE tool like Cursor with full version control.
Is Bolt.new better than Lovable?
They are the two leading browser AI app builders and the honest answer depends on what you are building. We run both against the same prompts in our live duel and keep a scored comparison at claw.mobile/tools, and the full Bolt review covers where it wins and loses.

Stuck at 80 percent? We take over half-finished builds.