> 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/ai-workbench-qore/console/app-builder/app-workspace.md).

# App Workspace

Build, preview, inspect, test, version, and share your app.

The app workspace is where you build, inspect, test, and share an app. Describe a change, review the live preview, then move through the App Builder workflow.

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-af73c769ef5a758d0be029d8ed48258e46258bd8%2Fqore_app-builder_studio-import-an-existing-app-example_rounded_shadow.png?alt=media" alt="The app workspace, with the build conversation, live preview, and workspace panels"><figcaption><p>The app workspace.</p></figcaption></figure>

<table data-view="cards"><thead><tr><th>Next step</th><th data-card-target data-type="content-ref">Open</th></tr></thead><tbody><tr><td>Set up data, domains, and integrations</td><td><a href="/ai-workbench-qore/console/app-builder/build/app-config.md">App Config</a></td></tr><tr><td>Validate the app before release</td><td><a href="/ai-workbench-qore/console/app-builder/testing.md">Testing</a></td></tr><tr><td>Publish the current version</td><td><a href="/ai-workbench-qore/console/app-builder/deploy.md">Deploy</a></td></tr></tbody></table>

### Describe and build

Use the conversation to describe the change you want. Qore plans the work, waits for your approval, builds the app, and confirms when **Live preview is ready**.

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-50b60905dafa474b902a8b656f6761bc1a5ab7a6%2Fqore_app-builder_studio-app-builder-building-by-chatting_rounded_shadow.png?alt=media" alt="The build conversation, describing a change and showing the plan/approve/build flow"><figcaption><p>Describing a change in the build conversation.</p></figcaption></figure>

Each turn shows its work time and token usage. Open the token total for model-level input and output usage.

While the build agent works, the conversation shows **Working…** and each step it takes, such as finding, reading, or running files, with a tick when each is done. Select **Stop** to stop it.

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-a97c8e1d9322749f8dc7a61f95b790cac52b3363%2Fqore_app-builder_how-to-build-agent-working_rounded_shadow.png?alt=media" alt="The build conversation with the agent Working, listing its steps with ticks, and a Stop button above the Describe the changes you want box"><figcaption><p>The build agent at work, with Stop.</p></figcaption></figure>

A single request can run for up to 45 minutes. If it runs longer, Qore stops it, saves the work done so far, and replies: *This request ran too long and was stopped. The work done so far is saved — send a follow-up to continue, or split the request into smaller steps.* If code generation fails, the reply reads *We are currently experiencing an issue with code generation. Please try again or switch to a different model.*

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-5414d627a0eb7c928e1a7610b3b577c47fa8a2c5%2Fqore_app-builder_studio-import-an-existing-app-token-usage_rounded_shadow.png?alt=media" alt="The token usage breakdown for a build turn, showing model-level input and output usage"><figcaption><p>Model-level token usage for a build turn.</p></figcaption></figure>

#### Fix errors

Forward a preview error to the build agent. When the preview hits an error, a bar at the bottom of the build conversation shows it — for example `UNHANDLED_REJECTION` — with **Fix with AI**. Select **Fix with AI** to send it. The request includes the error type and message. Qore fixes the app and rebuilds the preview.

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-463a070e45de3fa2fdb0ae83fca36205f8ef3906%2Fqore_app-builder_how-to-error-bar-fix-with-ai_rounded_shadow.png?alt=media" alt="The build conversation ending with a summary of changes, Live preview is ready, Upgrade your app with Add an AI Agent, and a red error bar reading UNHANDLED_REJECTION with a Fix with AI button"><figcaption><p>A preview error, with Fix with AI.</p></figcaption></figure>

{% hint style="info" %}
Fixing an error is another conversation turn. Describe or forward the error, then review the rebuilt preview.
{% endhint %}

{% hint style="info" %}
**Fix with AI** sends the reported issue to Qore's build agent. Review the rebuilt preview before you continue.
{% endhint %}

### Continue building

Choose a suggested next step, or enter another request. **Upgrade your app** can add a database for persistent data or an AI agent for app intelligence — for example **Add an AI Agent** (*Connect intelligence to your app*).

{% hint style="info" %}
Each round follows the same flow: plan, approve, and build. Nothing is built before you approve the plan.
{% endhint %}

### Preview

Use the live preview after every change. The toolbar above it has reload and full-screen icons, and desktop, tablet, and mobile widths to check responsiveness. Each preview includes a **Built with QORE** badge.

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-742aacd258d719f3f56dc1468fd251cf7d4ad01b%2Fqore_app-builder_how-to-preview-toolbar_rounded_shadow.png?alt=media" alt="The Preview tab showing a running app, with reload, full-screen, and desktop, tablet and mobile icons above it, and a Built with QORE badge"><figcaption><p>The live preview.</p></figcaption></figure>

### Explore the workspace

Switch the centre panel between **Preview**, **Code**, and **Agents**.

#### Code

* Inspect the generated source in the file tree. It includes the frontend, tests, project configuration, `app.run.json`, and `APPLICATION_PLAN.md`.
* Select a file to read it, edit it, download it, or connect its repository to GitHub. To edit, select **Edit**, make your changes, then select **Save**. Saving an edit creates a new version.
* Use the build conversation for most app changes.

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-2dd359973434e54b175c7b7f97f6915d7a1fc201%2Fqore_app-builder_studio-app-builder-code-edit_rounded_shadow.png?alt=media" alt="The Code panel, showing the generated file tree and an open source file"><figcaption><p>Inspecting and editing generated source in the Code panel.</p></figcaption></figure>

#### Agents

* Use **Agents** to add automation, data processing, and logic.
* Select **Build an Agent** for a new agent, or **Attach Agents** for an existing one.
* For attachment steps, see [Integrate an agent](/ai-workbench-qore/task-guides/integrate-an-agent.md).

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-26aef8aadd88fb89c9bf6b17c8a0f723b59715b7%2Fqore_app-builder_studio-app-builder-agents-attach-agents_rounded_shadow.png?alt=media" alt="The Attach Agents dialog, listing existing agents to attach to the app"><figcaption><p>Attaching an existing agent to the app.</p></figcaption></figure>

### Credits

The Credits meter shows what this app has consumed—the Credits used, the Cost, and when the figure was last synced. Building an app spends credits, so keep an eye on it as you iterate. For account-wide usage and limits, see [Billing](/ai-workbench-qore/control-center/cost-control.md).

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-cbaea4971b83d7524e46d3967d5decf8ef2d0648%2Fqore_app-builder_studio-import-an-existing-app-example-credits-usage_rounded_shadow.png?alt=media" alt="The Credits meter, showing credits used, cost, and last synced time"><figcaption><p>The Credits meter.</p></figcaption></figure>

### Versions and publishing

The version selector lists builds newest first. **Latest** marks the newest build. **Published** marks the version users see. *Uncommitted changes* marks work outside a version.

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-eeb65a4b742e2c0c55d8c41c2fdf8bb1c7f714c1%2Fqore_app-builder_studio-import-an-existing-app-example-version_rounded_shadow.png?alt=media" alt="The version selector, listing builds newest first with Latest and Published markers"><figcaption><p>The version selector.</p></figcaption></figure>

Select a version in the selector. **Preview Version** opens for it, for example: *You are about to view Version 5.0.0 from Sep 11, 2026, 9:50 PM. This will temporarily load the selected version. Your current version will remain unchanged.* Choose one:

* **View Version** (for example **View Version 5.0.0**) — loads that version temporarily.
* **Revert to Version** (for example **Revert to Version 5.0.0**) — reverts the app to that version.

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-6a6a2a5fb631324f8e6194d88920f634f682f61c%2Fqore_app-builder_how-to-version-preview-dialog_rounded_shadow.png?alt=media" alt="The Preview Version 5.0.0 dialog: you are about to view Version 5.0.0 from Sep 11, 2026, 9:50 PM; this will temporarily load the selected version and your current version will remain unchanged; Revert to Version 5.0.0 and View Version 5.0.0 buttons"><figcaption><p>Preview Version.</p></figcaption></figure>

While you view an older version, a bar reads **Viewing Version** with the version number, for example **Viewing Version 5.0.0**. Select **Back to Latest** to return to the newest version, or **Revert to Version** to revert to the one you're viewing.

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-ee43eddf3e3398f3e6042df8b1b5ce3a96519b7a%2Fqore_app-builder_how-to-version-viewing-bar_rounded_shadow.png?alt=media" alt="A bar reading Viewing Version 5.0.0, with Back to Latest and Revert to Version 5.0.0 buttons"><figcaption><p>Viewing an older version.</p></figcaption></figure>

To make a version live, follow [Deploy an app](/ai-workbench-qore/console/app-builder/deploy.md).

### Share

Select **Share**, beside the version selector, to share the app.

### Export

Select the export icon in the workspace top bar, beside **Share**, to bundle the app into one package: its frontend, backend, AI agent logic, database schema, and cloud storage configuration. You need the **Export App** capability; without it the button is disabled. It isn't shown while the app is still in its initial plan.

In the **Export App Package** dialog, tick **Include chat history in package** if you want the build conversation in the package (it's off by default), then select **Export Package**. The package isn't downloaded in your browser. Qore shows *Export started. You will receive an email when it is ready.*

<figure><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-0574ffa93330ec60348a2711e373e0c461285a5f%2Fqore_app-builder_how-to-export-app-package_rounded_shadow.png?alt=media" alt="The Export App Package dialog, with the Include chat history in package checkbox and Cancel and Export Package buttons"><figcaption><p>Export App Package.</p></figcaption></figure>

### More

The **More** menu reflects the selected build version. Use it to inspect:

* [Analytics](/ai-workbench-qore/console/app-builder/analytics.md) for published-app engagement
* [DB Explorer](/ai-workbench-qore/console/app-builder/build/db-explorer.md) and [Data Flow](/ai-workbench-qore/console/app-builder/build/data-flow.md) for app data and architecture
* [Testing](/ai-workbench-qore/console/app-builder/testing.md) and [Security Scans](/ai-workbench-qore/console/app-builder/security-scans.md) before release

***

{% columns %}
{% column width="83.33333333333334%" %}

<p align="right"><em>Maintained by</em> <mark style="color:green;">Abhishek Paul</mark><br><code>AI-assisted, human-approved</code></p>
{% endcolumn %}

{% column width="16.666666666666664%" %}

<div align="left"><img src="https://1326225582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0qmgQjJ5aArDTj2ACFHG%2Fuploads%2Fgit-blob-d034645b4f8f8ee661985f5306b60ded3289653c%2Fmaintainer-abhishek-paul.png?alt=media" alt="" width="60"></div>
{% endcolumn %}
{% endcolumns %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.uptiq.ai/ai-workbench-qore/console/app-builder/app-workspace.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.