Importing apps
Create apps from prompts, packages, repositories, or your own IDE.
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 what kind of app it is, pick the model that builds it, and start the build. Qore opens the app workspace and works through your request. If you'd rather not start from scratch, pick one of the starter templates offered beneath the prompt.

The app type menu, which reads Web App by default, offers four types:
Web App — Traditional web app with pages, data and a backend.
Website — Landing pages, marketing websites, SEO friendly.
Mobile (Beta) — Native mobile app for Android and iOS.
To change the model, open the model menu beside the app type, which shows the current model, such as Gemini 3 Flash Preview. Each model carries its provider's logo: Claude for Anthropic, Gemini for Google, and OpenAI. A model from any other provider shows a generic sparkle icon. When the list holds more than six models, a Search models box at the top lets you type part of a name to narrow it. The current model is ticked.

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.

Import a ZIP
Upload a ZIP and the dialog moves to a second step that reads Name your app and pick the model that will work on it. It shows the file name and size, a Name field and a Model menu, with Cancel and Import. A message reads App imported successfully, and the app workspace opens with the build agent already working.
Import from GitHub
Choose GitHub, then:


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.

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.

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 <BASE_URL>/app-builder/api/v1/mcp and every request must carry the header x-platform-key. Replace <BASE_URL> with the Qore API host your organization uses — confirm it with your platform administrator, as it differs by deployment.
Read a turn's token usage
The App Builder MCP server has a tool, get_app_turn_token_usage, and the public API a matching route, GET /api/v1/apps/{appId}/turn-token-usage/{messageId}. Both return the token usage of one build turn. messageId is the ID of the agent reply that the run produced. The caller needs the ViewApp capability.
The response has the same shape either way:
A run still in progress can report partial usage. A 404 with app_not_found means no app with that ID exists for the account, or no usage is recorded for that message.
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
App WorkspaceLast updated
Was this helpful?

