Skip to main content

Create, import, export, and delete apps

When to use this guide​

Use this guide when you start a new project, take over a project from a teammate, prepare an offline delivery, or remove an app you no longer need.

Before you start​

  • Complete these tasks in the desktop App Hub, not on a runtime page.
  • Before importing a local project or Git repository, confirm that its root is a valid Theseus app.
  • Push to Git or export a ZIP before deleting an app.
  • To enable Qixin Code while creating an app, sign in to Qixin first and make sure your account has a name.

Steps​

Create a blank app​

  1. Select Create in the App Hub sidebar.
  2. Select Blank app.
  3. Enter an app name, then enter an empty directory in Workspace path.
  4. Turn on Qixin Code if Qixin should host a private repository for the app.
  5. Select Save. Theseus opens the new app in the editor.

Import a ZIP​

  1. Select Import in the App Hub sidebar.
  2. Choose a .zip app package.
  3. Wait for the app to appear in the list.
  4. Double-click its card. Review Pages, Objects, and Settings before using Run or Debug.

ZIP import is suitable for offline delivery and backup recovery. It does not include the original Git history.

Import from Git​

  1. Select Create, then open Git import.
  2. Enter the repository URL. Enter Branch when you need a specific branch.
  3. Enter an empty local directory in Workspace path.
  4. Select Import from Git and wait for the task to finish.
  5. If authentication fails, use the prompt to enter a repository account and access token, then retry. Never put a token in the repository URL.

Register an existing project​

  1. Select Create, then open Project.
  2. Enter the existing app's root directory in Workspace path.
  3. Select Register project.

Registration does not copy the project. Unregister it from the App Hub before moving or deleting the original directory.

Export an app​

  1. Open the context menu on the app card.
  2. Select Export, then choose a destination.
  3. Give the ZIP to the recipient together with the required Theseus version, runtime target, and site-configuration notes.

Delete or unregister an app​

  1. Open the context menu on the app card and select Delete.
  2. To remove only the App Hub entry, clear Delete workspace files from disk.
  3. To delete the project directory as well, keep the option selected and confirm the deletion.

What success looks like​

  • A created or imported app appears in the App Hub and opens in the editor.
  • After a Git import, the Git panel shows the expected branch and remote.
  • The exported ZIP can be imported on another desktop installation.
  • Unregistering removes the app from the list but keeps its directory. Deleting workspace files removes both.

Common issues​

The imported app says that it needs repair​

The app is registered, but the current Theseus version cannot load part of it. Open the editor and review Problems and the related settings before running it on equipment.

Open runtime says that no home page is set​

Choose a home page in Settings → General, or right-click a page under Resources → Pages and set it as the home page.

Git import keeps failing authentication​

Confirm that the repository is reachable and that the token can read it, then retry through the authentication prompt. Do not embed a username or token in the URL.

I accidentally selected Delete workspace files from disk​

Deletion has no undo action. Restore the app from a remote repository, an exported ZIP, or another backup.

How AI can help​

AI Command Center operates only on the app that is already open. It cannot replace the App Hub for creating, importing, exporting, or deleting apps. After opening an imported app, try:

Inspect the current imported app for completeness. Do not modify files. List anything that blocks Build, Run, or Debug, and give me a verification order.

Before a repair, use @ to reference the failing files and ask AI to explain its plan and scope. Afterward, ask for the changed-file list and the checks it ran.

What a person must confirm​

  • The app name and workspace path belong to the correct customer and project.
  • The Git repository and branch are correct and contain no site information that should remain private.
  • The ZIP imports in the destination environment and its version and dependency requirements are documented.
  • A recoverable remote commit or ZIP backup exists before deletion.