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

# Overview

> Build Mode turns your requirements into a running application with a database behind it, through a conversation with the build agent.

<Frame caption="Build Mode. The conversation runs down the left; the composer carries the mode selector, quality selector, and agent settings.">
  <img src="https://mintcdn.com/bluegenai/NDGsqiI6WIlzZ3zL/images/web-apps/build-mode-overview-composer.png?fit=max&auto=format&n=NDGsqiI6WIlzZ3zL&q=85&s=b6949705630937ab49ced78f93b833e6" alt="The Build Mode workspace showing a conversation with a user message and an agent response, above a composer with a paperclip, a Build dropdown, a High dropdown, a settings gear with a badge reading one, and a send button." width="1533" height="757" data-path="images/web-apps/build-mode-overview-composer.png" />
</Frame>

## How It Differs from Prototype Mode

[Prototype Mode](/web-apps/prototype-mode/overview) mocks up a front end using primarily html and with no infrastructure behind it. Build Mode builds the real thing: front end, backend, database, and everything needed to run and connect them.

A prototype can be modified in seconds, making it useful to support requirement sessions or design discussions. A build takes longer because it requires substantive edits to a full application.

<Note>
  **Build Mode starts a fresh conversation.** It does not inherit your Prototype Mode chat history, and it does not pick up your Design System either. Anything from prototyping that should influence the build has to be attached to your prompt. See [Output Handoff](/web-apps/prototype-mode/output-handoff).
</Note>

## The Panel Rail

The icons at the top right open panels beside your work. **Ten in Prototype Mode, eleven in Build**, which adds Testing Context.

<Frame caption="The panel rail in Build Mode, with every icon named.">
  <img src="https://mintcdn.com/bluegenai/12TAzfQxwOYFdfBc/images/getting-started/navigation-ui-guide-panel-rail.png?fit=max&auto=format&n=12TAzfQxwOYFdfBc&q=85&s=faa640f1d127df1d17da7a664e13544e" alt="A magnified view of the eleven panel rail icons in Build Mode, each labelled: Files, Design System, URLs, Preview, Codebase, Database, Credentials, MCP Servers, Testing Context, Stop App and Manage Collaborators, set against a faded view of the workspace so the rail's position at the top right is clear." width="1328" height="652" data-path="images/getting-started/navigation-ui-guide-panel-rail.png" />
</Frame>

| Panel                | What it holds                                          |
| :------------------- | :----------------------------------------------------- |
| Files                | Everything uploaded to or generated by the project     |
| Design System        | Colours, type, and spacing for generated prototypes    |
| URLs                 | Your running application's addresses                   |
| Preview              | The running application, embedded                      |
| Codebase             | The generated source, and the version-control controls |
| Database             | The application's data, browsable and queryable        |
| Credentials          | Keys the agent has asked you for                       |
| MCP Servers          | External tools connected to the build agent            |
| Testing Context      | What the testing agent should know (**Build only**)    |
| Stop App             | Stops the running application                          |
| Manage Collaborators | Invitations and sharing                                |

<Tip>
  Hover one any of the icons to see its label.
</Tip>

## Two Ways of Talking to the Agent

Inside Build Mode the agent chat box carries its own selector with two options, and the distinction matters.

| Composer option | What it does                                            |
| --------------- | ------------------------------------------------------- |
| **Build**       | Creates, edits, and ships changes to your codebase      |
| **Ask**         | Answers questions about your codebase, changing nothing |

**Build is the default.** Ask is a read-only sub-mode you switch to when you want to understand something rather than change it.

<Note>
  "Build" is the name of both the mode tab and the composer's default option.

  They are not the same control: the tab decides which workspace you are in, and the composer decides what the agent does with your next message.

  Throughout this documentation, **Build Mode** means the workspace and the composer's **Build option** means the selector.
</Note>

The difference is enforced rather than advisory. In Ask, the agent is given only tools that read; it cannot write a file or run a command even if you ask it to. See [Ask Mode](/web-apps/ask-mode).

<Frame>
  <img src="https://mintcdn.com/bluegenai/TMjN9YHQYhMQnTkP/images/image-9.png?fit=max&auto=format&n=TMjN9YHQYhMQnTkP&q=85&s=cea314936fb6ca7d72904b3f0f8103e3" alt="Image" width="731" height="225" data-path="images/image-9.png" />
</Frame>

## Choosing a Quality Setting

Beside the composer's mode selector sits a quality selector offering **Medium** and **High**.

<Warning>
  Build offers two settings in a **MODEL SELECTION** drop down. This selection is un-related to the model selection in the ***CAB mode***
</Warning>

## When to Use Build

* **The requirements are settled enough to build against.** Tickets, a corrected blueprint, or a ready concept you can manage manually.
* **You need a comprehensive prototype.** When you want to explore a thorough and detailed prototype with actual and real foundational architecture.
* **You need something people can use or which can be shared.** A build will be a full application and hosted with a URL you can share with stakeholders.

## When Not To

* **You are still deciding what to make.** If you are still Refining your CAB, Iterating mockups in Prototype Mode, or reviewing and adding tickets - you may want to wait to initiate your Build.
* **You only want to understand existing code.** Use the composer's Ask option, which changes nothing.

## Your Next Step

A build starts with a prompt, and what happens next is worth knowing before you send one.

<CardGroup cols={2}>
  <Card title="Run your first build" icon="play" href="/web-apps/build-mode/workflow">
    What happens after you send a build prompt.
  </Card>

  <Card title="See what the agent can do" icon="robot" href="/web-apps/build-mode/build-agent-guide">
    Its tools, its rules, and the limits it works within.
  </Card>
</CardGroup>


## Related topics

- [Overview](/web-apps/prototype-mode/overview.md)
