Getting Started with Bolt.new
Bolt.new is a browser-based AI tool that lets you build, preview, and publish full web apps without installing anything. Describe what you want, see it live in seconds, and publish with one click.
In this chapter
- How to set up Bolt.new and start your first project
- 3 starter prompts you can copy-paste right now
- Tips and tricks specific to Bolt.new
- Common first-time issues and how to avoid them
How to Get Started
-
1
Go to bolt.new Open bolt.new in your browser. You can start building right away with the free tier, or sign up for more features. No downloads or installs needed.
-
2
Describe what you want to build Type a description of your project in the prompt box. Be specific about the features, pages, and design you want. Bolt will generate a full working project with a live preview.
-
3
Preview and publish Your app appears in a live preview panel. Test it out, make changes with follow-up prompts, and when you're happy, click Publish (top right) to put it online at a free address ending in bolt.host.
Your First 3 Prompts
1. Build your first project
“Build a recipe collection website with a grid of recipe cards. Each card shows an image, name, cooking time, and difficulty. Clicking a card shows the full recipe with ingredients and steps.”
2. Add search and filters
“Add a search bar that filters recipes by name and a sidebar with category filters.”
3. Add user features
“Add user accounts so people can save their favorite recipes and submit their own.”
Tips for Working with Bolt.new
Describe the full page in your first prompt
Include the layout, sections, and functionality you want. Bolt works best when it understands the complete picture from the start.
Use the preview to catch issues early
Click through your app in the preview panel after every change. Test buttons, links, and forms. It's easier to fix things right away.
Ask for specific frameworks
Bolt supports React, Next.js, Vue, Svelte, and more. If you have a preference, say so in your prompt.
Export your code to GitHub
Once your project is working, export it to GitHub so you have a backup and can continue editing in other tools.
Keep prompts focused on one change
Instead of 'add dark mode, fix the footer, and add a new page', make three separate prompts for better results.
Common First Issues
Browser can feel slow on complex apps
Since everything runs in the browser, very large projects may feel sluggish. Keep your MVP focused.
Check the terminal for errors
If something looks wrong, check the terminal panel at the bottom. Error messages there help you debug.
Use version history to undo
Bolt saves versions automatically. If a prompt breaks something, open Version history (the clock icon) and restore an earlier version. Connect GitHub for a backup outside Bolt.