
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
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.
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
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 colorsCompare 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.
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.
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
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.
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.
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
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?
What to Build First
Personal Landing Page
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
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
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 When | Use an IDE When |
|---|---|
| Prototyping a new idea quickly | Working on an existing large codebase |
| Building a landing page or simple app | Building something with complex backend logic |
| You want zero setup overhead | You need custom dev tooling and debugging |
| Sharing a quick demo or proof-of-concept | Working with a team using git branching |
| You are a non-developer exploring ideas | You need fine-grained version control |
Built something with Bolt?
Compare Bolt against other app builders, or submit your project to the showcase.