> ## 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.

# Quick Start Guide

> One pass through the whole platform: upload requirements, generate a specification, break it into work, prototype it, build it, and open the result.

This guide runs a project through every stage the platform offers, from a requirements document to an application you can open.

It is deliberately end to end. Each stage produces something the next one uses, and seeing that chain once is more useful than reading about any single part of it.

<Note>
  **Before you start:** you need an account and something to build from, such as a requirements document, a solicitation, or an existing codebase. Anything the platform can read is enough to begin.
</Note>

<Steps>
  <Step title="Create a project">
    Select **Create Project** on the dashboard. Give it a title, choose **Web Application**, and create it.

    <Frame caption="Creating a web project. Only the title is required.">
      <img src="https://mintcdn.com/bluegenai/NDGsqiI6WIlzZ3zL/images/getting-started/quick-start-guide-create-project.png?fit=max&auto=format&n=NDGsqiI6WIlzZ3zL&q=85&s=2d9a47b84ef7e0f1f466f771a2ee4517" alt="The Create New Project drawer showing a project title field, Project Type options for Web Application and Low Code Application, a Platform Type description, and client name and custom domain fields." width="1440" height="757" data-path="images/getting-started/quick-start-guide-create-project.png" />
    </Frame>

    By default, the project opens into the CAB, which is where every project starts.
  </Step>

  <Step title="Upload your chosen content and generate your Common Application Blueprint.">
    Upload documents or a source archive, leave all ten sections selected, and select **Generate Blueprint**.

    <Frame caption="The CAB workspace. Upload on the left, the generated blueprint on the right.">
      <img src="https://mintcdn.com/bluegenai/NDGsqiI6WIlzZ3zL/images/getting-started/quick-start-guide-cab-upload.png?fit=max&auto=format&n=NDGsqiI6WIlzZ3zL&q=85&s=6ee0fe7005f8a75a5c2e9b0e575cd708" alt="The CAB workspace showing the CAB Configuration tab with an upload area, and the blueprint preview pane to the right." width="1512" height="788" data-path="images/getting-started/quick-start-guide-cab-upload.png" />
    </Frame>

    Generation may take a while depending on the volume of content you upload. The CAB process assesses everything you uploaded and writes a full specification. The preview populates when it finishes.

    **What you should see:** a document covering the project's identity, its user stories, its data model, screens, roles, workflows, rules, reporting, integrations, and a list of questions your source material left unanswered.

    Read the **Suggested Questions** section first. It is the platform telling you where your requirements are thin, and it is usually the most valuable output of this step.

    See [Step-by-Step Workflow](/cab/step-by-step-workflow) for what happens during generation.
  </Step>

  <Step title="Refine your CAB">
    Select **Edit CAB** to change anything the platform misread, or ask the **BlueGenAI CAB Agent** to make a change for you.

    Either way the change goes to a review screen where you accept or discard each one before it is written. Saving creates a version you can return to.

    <Tip>
      Everything downstream is generated from this document! Spending the time to clarify requirements and update your CAB will result in the best possible build, testing, and support clear traceability.
    </Tip>

    See [Editing your CAB](/cab/editing-your-cab).
  </Step>

  <Step title="Turn the Specification into a Plan">
    Select **Generate Tickets** in the blueprint toolbar, then open the **Tickets** tab.

    <Frame caption="Tickets generated from the specification. Each traces back to the requirement that produced it.">
      <img src="https://mintcdn.com/bluegenai/NDGsqiI6WIlzZ3zL/images/getting-started/quick-start-guide-tickets.png?fit=max&auto=format&n=NDGsqiI6WIlzZ3zL&q=85&s=c47fc1790f6f30c7b13cf351e4cfd1d7" alt="The Tickets list showing generated tickets with ID, title, status, priority, work type, source and created date columns." width="1512" height="788" data-path="images/getting-started/quick-start-guide-tickets.png" />
    </Frame>

    Each Ticket carries the user story it came from, including its acceptance criteria, and a reference back to the blueprint element that produced it.

    Open the **Epics** view. Tickets are grouped into Epics, and each Epic is a wave in the build order; Wave 1 holds the foundations everything else depends on.

    **What you should see:** a numbered list of Tickets, and an Epics view where each Epic carries a wave number and a progress count.

    See [Tickets](/tickets/what-are-tickets) and [Epics](/tickets/epics).
  </Step>

  <Step title="Build it">
    Switch to **Build**. This starts a fresh conversation, so attach the prototype files you saved and reference the Tickets you want built.

    Type `@` followed by at least two characters to reference a Ticket. Keep the number small, and stay within one Epic; the waves are ordered for a reason.

    <Frame>
      <img src="https://mintcdn.com/bluegenai/sutK1ZAHPqH0j2v2/images/build-mode-ticket-mention.png?fit=max&auto=format&n=sutK1ZAHPqH0j2v2&q=85&s=c7f2b32478b15e9f199d8ef5acf13f75" alt="Build Mode Ticket Mention" width="1533" height="757" data-path="images/build-mode-ticket-mention.png" />
    </Frame>

    The agent classifies your request, asks questions if it is ambiguous, then writes the application, runs it, and fixes what breaks before replying.

    **What you should see:** a summary of what changed and a URL for your running application.

    See [Using Tickets to Build](/tickets/using-tickets-in-build-mode) and [Build Mode](/web-apps/build-mode/overview).
  </Step>

  <Step title="Test as you Go">
    With **App testing** enabled, the agent opens your application in a browser after building and works through it, checking the acceptance criteria that came from your original requirements.

    Open the URL from the agent's reply, or from **URLs** in the panel rail.

    See [App Testing](/web-apps/app-testing).
  </Step>

  <Step title="Review and Refine your build">
    Periodically assess your application as you build it! Make refinements as you go.

    Access your build via the URL provided on the **Application URLs** panel using credentials provided by the Builder. You may specify the builder create accounts for you as needed.

    When you are satisfied your application meets your requirements - present it to stakeholders and be sure to take credit for the massive time and cost savings!
  </Step>
</Steps>

## What You Just Did

You took source material, turned it into a reviewed specification, broke that into ordered work, reviewed and revised it before building it, built it, and had it tested against the acceptance criteria written in the original requirement.

**That SDLC chain is the secret formula to our platform's success.** Every Ticket traces to a requirement, every Epic sets a build order, and the tests exercise criteria that were written down before any code existed.

## Your Next Step

Run it again on something real. The second project is where the workflow starts paying off, because you already know what each stage hands to the next.

<CardGroup cols={2}>
  <Card title="Start with better requirements" icon="book-open" href="/cab/what-is-cab">
    What a CAB is, and why the platform generates it rather than asking you to write it.
  </Card>

  <Card title="Work with your team" icon="users" href="/getting-started/user-role-management">
    Roles, invitations, and the two kinds of sharing.
  </Card>
</CardGroup>


## Related topics

- [BlueGenAI Documentation](/index.md)
- [Deployment Guide](/web-apps/build-mode/deployment-guide.md)
- [Navigation & UI Guide](/getting-started/navigation-ui-guide.md)
- [Component Reference](/low-code/salesforce/build-mode/component-reference.md)
- [Platform Overview & Architecture](/getting-started/platform-overview-architecture.md)
