This guide is for people who are new to Bolt and software development. It’s designed to help you plan your project, create a good first , and understand the steps involved in building an application.

​
The lifecycle of an application

​
Step 1: Design and plan

Before you start building, you need to know what you’re building and why. Bolt provides multiple ways to add your designs: Although you can start with an open-ended prompt, such as Hey Bolt, please build a todo list app, you’ll have more success if you design and plan first. Try to come up with answers to the following questions. What do you want to build? In general terms, what are you creating? For example: a todo list application, or a portfolio website, or a mobile habit tracker app. Who is it for? Your user should be at the center of your design choices. Think about what they need and how they’ll use your application. What features does it have? List out the features: the things users can do. For example, if building a to-do list app, your feature list might include:
  • Create new todos
  • Edit existing todos
  • Delete todos
  • Schedule the time and date for a todo
What look and feel do you want? Give Bolt guidance on the aesthetic you want for your application. You can describe it, or attach images for inspiration. How will users access it? It’s important to make this decision at the start, so that Bolt can structure your application to work with the platforms you want to publish to. Think about the format:
  • Website: the user accesses this in their browser. It’s mostly content and information. For example: blogs, news sites, portfolios, galleries, and so on.
  • Web application: the user accesses this in their browser. It’s interactive, allowing users to add their own data. It’s a tool, not just a content site. For example: Bolt is a web application!
  • Mobile application: the user installs an app on their phone or tablet.
Then you’ll prompt Bolt to build for the format you want:
  • If users will access your application in their browser, the easiest way is to publish and host using Bolt’s built-in hosting.
  • If you want to build a mobile app, Bolt integrates with Expo, which allows you to build your application once, then package it up for multiple platforms.
An example answer
I want to build a todo list app. It’s for people who love timeblocking and the pomodoro productivty method. Its features should include: adding and scheduling todos, and a pomodoro timer. It should have a modern, clean, but colorful aesthetic. Users should be able to add, edit, and delete todos. Users should be able to schedule the time and date for their todos. Users should be able to view both their unscheduled task list, and a daily schedule with any scheduled tasks. Users will access the application in their browser, so make sure it’s suitable for hosting on Netlify.

​
Step 2: Your first prompt

Writing good prompts is key to success with AI tools.
For detailed guidance, there’s a full best practices article on how to prompt effectively. It’s recommended to read this in full. You may also want to check out Intro to LLMs for a quick introduction to AI terminology and concepts.
If you built up answers to the questions above, you can use those as the basis for your first prompt. Before you start, use Bolt to improve your prompt:
  1. Write your prompt in the chatbox.
  2. Click Enhance prompt Star icon. Bolt generates a recommended prompt, which you can then edit.
"Gif showing a short prompt being copied into Bolt, the user clicks enhance prompt, and Bolt converts it to a more detailed prompt" For example, taking the example answer from the previous section and enhancing it generates a much longer, more detailed prompt.
Once you enhance your prompt, read through the new prompt to make sure it still does what you want.

​
Step 3: Iterate

After Bolt generates your application from your first prompt, you’ll probably want to make changes:
  • Adding more features.
  • Tweaking behavior or appearance.
  • Fixing bugs.
Do one thing at a time. Don’t try to add multiple features in one go. Remember the guidance in prompt effectively. Read the guides to working in Bolt for help using Bolt’s interface.

​
Step 4: Publish

After building your application, the next step is to make it available to users. This is where publishing and hosting come in. The easiest way to publish your app is to use Bolt hosting, but you also have other options. You can choose to:
  • Use Bolt’s Netlify integration: this connects Bolt to Netlify, enabling one-click publishing from within Bolt. Follow the Netlify integration guide to set this up and to learn more about building for Netlify.
  • For mobile applications, build with Expo and publish to the app stores. Follow the Expo integration guide.
  • Connect to GitHub and set up publishing from GitHub using other CI/CD tools: this is a common devops pattern. The GitHub integration guide walks you through connecting Bolt and GitHub. You’ll then need to set up your own build and publishing tools.
  • Download your project, and use any publishing option you prefer.
If you’re new to building applications and unsure which option to choose, Bolt’s built-in hosting is usually the best option. Now that you’re ready to use Bolt hosting or you’ve successfully connected to Netlify, Expo, or GitHub by following the instructions above, the final step is to publish your application. In the top-right corner, click the Publish button to open a dropdown menu with the following options:
  1. A URL to your published site, which you can copy and share as needed.
  2. The timestamp of the most recent publish.
  3. Share buttons for X (formerly Twitter), LinkedIn, and Reddit.
Publish Dropdown Gi