> For the complete documentation index, see [llms.txt](https://docs.uptiq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uptiq.ai/workflow-guides/create-an-app.md).

# Create an app

Create an app from the Dashboard prompt. Then review it in App Builder, refine it, and publish it.

## Prerequisites

{% hint style="info" %}
You need access to a Qore workspace and a rough idea of what to build. You can also start from a template.
{% endhint %}

## Steps

{% stepper %}
{% step %}

### Start from the Dashboard prompt

On the Dashboard, use the **chat** prompt box. Make sure the **App** tab (below the box) is selected — not Agent.

<figure><img src="/files/iECWDgGxEEBQRj1qIIaU" alt=""><figcaption><p>The Dashboard prompt box, with the App/Agent tabs, Web/Mobile toggle, and model and mode controls</p></figcaption></figure>
{% endstep %}

{% step %}

### Set your options

Set the following options:

* **Target:** Choose **Web** or **Mobile (Beta)**.
* **Model:** Choose a model, such as Gemini 3 Flash.
* **Mode:** Leave this on **Build**. Use **Plan** first to align on logic. See [Plan Mode vs Build Mode](/workflow-guides/plan-vs-build-mode.md).
* **Assets:** Use the **+** menu to **Attach File** or **Import App Package**.
* **Branding:** Use the branding icon to set colors and logos.

<figure><img src="/files/Nm7OM52QVsgDEKH8NebH" alt=""><figcaption><p>The + menu in the prompt box, with Attach File and Import App Package</p></figcaption></figure>
{% endstep %}

{% step %}

### Describe the app and submit

Describe what you want to build. For example: *"Create a Web app for Loan Lead Capture with an email input and submit button."* Press the send arrow or Enter.

{% hint style="info" %}
**Shortcut:** click a **template card** instead of writing a prompt to have the platform draft the requirements for you.
{% endhint %}
{% endstep %}

{% step %}

### Wait for the environment to spin up

The platform shows **"Spinning up Application Environment"**. It creates and auto-names the app, such as *Loan Lead Capture Pro*. Then it opens the app in the **App Builder** workspace.
{% endstep %}

{% step %}

### Watch it build, and answer any prompts

The left panel streams the build:

* It shows **Application initialized ✓**, then the components and steps.
* The build may **pause for a decision**.
* For example, **Select Provider** offers *Uptiq Managed Database* \[Recommended] or *Supabase* for a database.
* Approve or **Skip** the choice in the left chat to continue.

<figure><img src="/files/8Fwcj6VLyRpc0UD4JWBJ" alt=""><figcaption><p>The build pauses at the Select Provider step to choose a database</p></figcaption></figure>
{% endstep %}

{% step %}

### Preview and refine

When the build finishes, open **Preview** to view the running app. To make changes, enter a follow-up prompt in **"Describe the changes you want…"**. Use **Code** to inspect generated code. Use **Version History** to roll back.
{% endstep %}

{% step %}

### Publish

Use the **Publish** dropdown at the top-right to publish the app. **App Config** holds app-level settings.

<figure><img src="/files/MKdmJo4V7YLba5nzLirO" alt=""><figcaption><p>The finished app in the Preview tab, with Version History, App Config, and Publish in the top bar</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Verify

Your app is ready when the **Preview** reflects your requirements and responds to input. After publishing, confirm it's reachable from its published location.

## Common issues

* **My app started building before I finished planning.** Build Mode generates on every prompt. Use Plan Mode first to align.
* **The build seems stuck.** Check the left chat for an **"Agent is waiting for your input"** step. For example, choose a provider. Approve or Skip it.
* **The generated layout isn't right.** Don't rebuild — send a follow-up prompt in "Describe the changes you want…".

## Related pages

* [Get Started](broken://spaces/0qmgQjJ5aArDTj2ACFHG/pages/QsxktQ2po9Whjaaa5slS) and [Build](/app-builder/build.md)
* Add an external service: [How to connect an integration](/workflow-guides/how-to-connect-an-integration.md)
* Add intelligence: [How to create an agent](/workflow-guides/create-an-agent.md) and [integrate it into this app](/workflow-guides/integrate-an-agent.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.uptiq.ai/workflow-guides/create-an-app.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.