> 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/app-builder/creating-and-importing-apps.md).

# Importing apps

There are four ways to get an app into App Builder:

* Describe a new one from a prompt
* Import a project you already have
* Bring in a Git repository
* Connect your own IDE

This page covers each.

## Create a new app from a prompt

On the App Builder home, describe the app you want to build in the **Describe the app you want to create…** box, choose whether it targets **Web** or **Mobile** (Mobile is in beta), pick the model that builds it, and start the build. Qore opens the [app workspace](/app-builder/app-workspace.md) and works through your request. If you'd rather not start from scratch, pick one of the starter templates offered beneath the prompt.

<figure><img src="/files/1cHG3ktknVYpwlZ52AJz" alt="The app creation prompt box, with Web/Mobile target and model selection"><figcaption><p>Describing a new app and choosing its target and model.</p></figcaption></figure>

## Import an existing app

Choose **Import an existing app** to bring in an app you already have. You can supply it three ways:

* **Upload a package or project** — drag in, or select, a ZIP file up to 500 MB.
* **GitHub** — import a repository.
* **GitLab** — import a project.

<figure><img src="/files/npH8RDY6elogn4tcs88w" alt="The Import an existing app dialog, with Upload, GitHub, and GitLab options"><figcaption><p>The three ways to import an existing app.</p></figcaption></figure>

{% hint style="info" %}
A Qore **Platform package** is restored as-is — it comes back exactly as it was. Anything else — a Git repository, or a project exported from Lovable, v0, Bolt, or Figma Make — is **converted** into a Platform app. Expect a conversion step, not a byte-for-byte restore, for non-Platform sources.
{% endhint %}

### Import from GitHub

Choose **GitHub**, then:

{% stepper %}
{% step %}

#### Pick the connected account

{% endstep %}

{% step %}

#### Choose a Repository

{% endstep %}

{% step %}

#### Choose a Branch

This only becomes available once you've selected a repository.
{% endstep %}

{% step %}

#### Select Continue

Import that repository and branch.
{% endstep %}
{% endstepper %}

<figure><img src="/files/utlHDT6pGgmTYKtgkFpo" alt="The App Builder home, with the app creation prompt and the option to import an existing app"><figcaption><p>Starting a new app or importing an existing one from App Builder's home.</p></figcaption></figure>

<figure><img src="/files/kul2BndXuvEbzaoY3CXC" alt="The GitHub import flow, with account, repository, and branch selection"><figcaption><p>Importing a repository from GitHub.</p></figcaption></figure>

### Import from GitLab

Choose **GitLab**. If your GitLab account isn't connected yet, select **Connect GitLab** first, authorize Qore, and return to the tab to browse your projects.

{% hint style="info" %}
GitHub lets you select a repository and branch right away. GitLab requires an account connection before you can browse projects.
{% endhint %}

<figure><img src="/files/n9UVxl8aNVnZY0syLdTj" alt="The GitLab import flow, with project selection"><figcaption><p>Importing a project from GitLab.</p></figcaption></figure>

{% hint style="info" %}
Connecting GitHub or GitLab grants Qore access to your source account. Connect only the account you intend to import from.
{% endhint %}

## Build from your IDE

Choose **Build from your IDE** to connect an app to an MCP-capable coding agent — for example Claude Code or Cursor — so you can build it from your own editor.

<figure><img src="/files/SEQVer1KbDAnsuy5SYsL" alt="The Build from your IDE dialog, with API keys and the MCP server connection command"><figcaption><p>The Build from your IDE dialog.</p></figcaption></figure>

{% stepper %}
{% step %}

#### Create an API key

In the **Build from your IDE** dialog, under **API keys**, select **+ Add Key** and name it. The key connects your editor to this app. Each key shows its **Name**, a masked value, and a **Status**, and can be revoked at any time with **Revoke**. Before you've made one, the list reads *No keys yet.*

<figure><img src="/files/nPwTJDGG8ep03NlVC6jf" alt="The API keys list in the Build from your IDE dialog, showing name, masked value, status, and Revoke action"><figcaption><p>Managing API keys for IDE access, including Revoke.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Add the App Builder MCP server to your editor

Copy the connection command and run it in your coding agent, replacing `<YOUR_API_KEY>` with the key you created. The endpoint is `https://api-builder-qa.uptiq.dev/app-builder/api/v1/mcp` and every request must carry the header `x-platform-key`.

{% code title="Add the App Builder MCP server (Claude Code)" overflow="wrap" %}

```bash
claude mcp add --transport http app-builder https://api-builder-qa.uptiq.dev/app-builder/api/v1/mcp \
  --header "x-platform-key: <YOUR_API_KEY>"
```

{% endcode %}
{% endstep %}

{% step %}

#### Build from your editor

With the server connected, your coding agent can build this app directly from your IDE.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
An API key is a credential — it grants an external tool access to build this app. Store it securely, and **Revoke** any key you no longer use.
{% endhint %}

## Why this matters

* You can start an app however suits you — a prompt, a package, a repository, or your own editor.
* What you import determines what you get: a Platform package restores exactly; everything else is converted.

## Related

{% content-ref url="/pages/bc7662d99efc00ab94438c3b32248b84a7af247f" %}
[App Workspace](/app-builder/app-workspace.md)
{% endcontent-ref %}


---

# 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/app-builder/creating-and-importing-apps.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.