> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackbox.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Step-by-step guide to launching your first project with Builder.

### Step 1: Launch Builder

Access Builder from your BLACKBOX AI dashboard or visit [build.blackbox.ai](https://build.blackbox.ai) directly.

### Step 2: Describe Your Vision

Click "New Project" to open the Builder canvas and begin your development journey. Describe the application you want to build in the initial prompt. Be as detailed as possible about:

* The purpose and functionality
* Target users and use cases
* Desired features and user experience
* Technical requirements or preferences

**Example prompts:**

* "I want to build a social media platform for sharing recipes, with user profiles, likes, comments, and recipe recommendations"
* "Create a task management app with real-time collaboration, file attachments, and deadline notifications"
* "Build an e-commerce platform with AI-powered product recommendations and integrated payment processing"

<img src="https://mintcdn.com/blackboxai-3b9e98f8/i8ImDSsUPPwUYrXi/images/builder/builder_UI.png?fit=max&auto=format&n=i8ImDSsUPPwUYrXi&q=85&s=cec622e7c224dc9048b70fcf6deb8fc6" alt="Enter Prompt" width="3148" height="2136" data-path="images/builder/builder_UI.png" />

### Step 3: Use Voice Input (Optional)

For a more natural interaction, use voice input to describe your project requirements. Simply click the microphone icon and speak your ideas.

<img src="https://mintcdn.com/blackboxai-3b9e98f8/ltKzjVqhiEpUDe3Y/images/builder/builder_use-voice_01.png?fit=max&auto=format&n=ltKzjVqhiEpUDe3Y&q=85&s=4dcd1e29420d9b4cc0701b8e9f520ff3" alt="Use Voice" width="3094" height="2116" data-path="images/builder/builder_use-voice_01.png" />

### Step 4: Watch Your App Build in Real-Time

Once you've selected your model, Builder begins building your application immediately. Watch as your idea transforms into reality:

* See components and features appear live on your screen
* Monitor the AI as it creates your application architecture
* Track progress through each development milestone
* Observe how different parts of your app connect and interact

<img src="https://mintcdn.com/blackboxai-3b9e98f8/i8ImDSsUPPwUYrXi/images/builder/builder_agent-builds_01.png?fit=max&auto=format&n=i8ImDSsUPPwUYrXi&q=85&s=369447a3df2219a870a70eaf2966eaae" alt="Agent Builds" width="3120" height="2132" data-path="images/builder/builder_agent-builds_01.png" />

### Step 5: See Your Initial Application

Within moments, your initial application comes to life. Builder creates a fully functional version based on your description:

* Review the generated interface and functionality
* Test the core features and user experience
* Explore the application structure and design
* Identify areas for improvement or customization

<img src="https://mintcdn.com/blackboxai-3b9e98f8/ltKzjVqhiEpUDe3Y/images/builder/builder_initial-site_01.png?fit=max&auto=format&n=ltKzjVqhiEpUDe3Y&q=85&s=d2e85ff95558660745692575b165f1ad" alt="Initial Site" width="3436" height="1978" data-path="images/builder/builder_initial-site_01.png" />

<Info>
  **Sandbox Environment Notice:** The application preview environment has a 45-minute session limit. Make sure to save your progress and deploy your application before the session expires to avoid losing your work.
</Info>

### Step 6: Iterative Customization

Now comes the exciting part - making your application truly yours through an iterative process of tweaks and improvements:

**First Round of Tweaks:**
Make your initial customizations and watch them happen in real-time:

* Describe changes in natural language
* Adjust colors, layouts, and styling
* Add or modify functionality
* Refine the user experience

<img src="https://mintcdn.com/blackboxai-3b9e98f8/ltKzjVqhiEpUDe3Y/images/builder/builder_tweak_01.png?fit=max&auto=format&n=ltKzjVqhiEpUDe3Y&q=85&s=b1797dcc38ad3f31de9e7ba174f30f83" alt="Tweaking" width="1728" height="232" data-path="images/builder/builder_tweak_01.png" />

**See Your Improvements:**
Review the results of your first round of changes:

<img src="https://mintcdn.com/blackboxai-3b9e98f8/i8ImDSsUPPwUYrXi/images/builder/builder_after-tweak_01.png?fit=max&auto=format&n=i8ImDSsUPPwUYrXi&q=85&s=22ef20ae45fbb46b6f564eb9a02328c6" alt="After Tweak 1" width="3412" height="2052" data-path="images/builder/builder_after-tweak_01.png" />

**Continue Refining:**
Make additional tweaks based on what you see:

* Advanced customization and feature enhancements
* Performance optimization
* Final design adjustments
* Polish the user interface

<img src="https://mintcdn.com/blackboxai-3b9e98f8/ltKzjVqhiEpUDe3Y/images/builder/builder_tweak_02.png?fit=max&auto=format&n=ltKzjVqhiEpUDe3Y&q=85&s=c8b333f97014c8fd916562f3076a2d02" alt="Tweak 2" width="2084" height="228" data-path="images/builder/builder_tweak_02.png" />

**Final Application:**
See your completed application ready for deployment:

<img src="https://mintcdn.com/blackboxai-3b9e98f8/ltKzjVqhiEpUDe3Y/images/builder/builder_final-site_01.png?fit=max&auto=format&n=ltKzjVqhiEpUDe3Y&q=85&s=f6dcd5c591acc1d1f062d6c34e8151a8" alt="Final Site" width="1502" height="1892" data-path="images/builder/builder_final-site_01.png" />

### Step 7: Deploy Your App

Launch your application to the world with flexible deployment options and get your live link:

**Choose Your Deployment Option:**
Select the hosting solution that best fits your needs:

* **BLACKBOX AI Hosting**: Quick deployment using BLACKBOX AI's infrastructure
* **Custom Domain**: Use your own domain for a professional presence
* **Community Sharing**: Showcase your creation in the community gallery

<img src="https://mintcdn.com/blackboxai-3b9e98f8/ltKzjVqhiEpUDe3Y/images/builder/builder_domain-options_01.png?fit=max&auto=format&n=ltKzjVqhiEpUDe3Y&q=85&s=4a938fcb0e3d0617701bfb751c4aa47c" alt="Buy or Use My Own Domain" width="808" height="492" data-path="images/builder/builder_domain-options_01.png" />

**Start Deployment:**
Launch your application with one click and track progress:

* **One-Click Process**: Instant publishing to your chosen platform
* **Automatic Optimization**: Built-in performance and security enhancements
* **Deployment Time**: Takes 5-10 minutes depending on your app's size and complexity
* **Real-Time Progress**: Monitor deployment status as it happens

<img src="https://mintcdn.com/blackboxai-3b9e98f8/ltKzjVqhiEpUDe3Y/images/builder/builder_deploy-to-bb_01.png?fit=max&auto=format&n=ltKzjVqhiEpUDe3Y&q=85&s=7182f236897d00e22640c613697eaa5d" alt="Deploy to BB" width="804" height="372" data-path="images/builder/builder_deploy-to-bb_01.png" />

**Get Your Live Link:**
Once deployment completes, receive your application's live URL:

* **Direct Access**: Get a link to your deployed application
* **Share Anywhere**: Send to users, clients, or friends
* **Professional URL**: Clean, accessible web address
* **Immediate Availability**: Your app is live and ready worldwide

<img src="https://mintcdn.com/blackboxai-3b9e98f8/ltKzjVqhiEpUDe3Y/images/builder/builder_deploy-success_01.png?fit=max&auto=format&n=ltKzjVqhiEpUDe3Y&q=85&s=6e4e05fdaa7a557a178327d9c0c2ff9f" alt="Deploy Success with Link" width="802" height="590" data-path="images/builder/builder_deploy-success_01.png" />

## Next Steps

<CardGroup>
  <Card title="Best Practices" icon="star" href="/features/builder/best-practices">
    Tips and guidelines for effective use of Builder
  </Card>

  <Card title="Key Features" icon="key" href="/features/builder/key-features">
    Detailed overview of Builder's capabilities and tools
  </Card>
</CardGroup>