App Hub and editor tour

Theseus Desktop uses App Hub as the entry point for projects. Opening a folder takes you to an App Hub conversation; choose Open editor when needed.

App Hub

Theseus Desktop opens App Hub first. Use it to create and enter local projects:

• New project creates a new project in the selected location.
• Open project selects a local .the project file and opens its editor.
• Open folder selects a local directory and enters a conversation, automatically recognizing a Theseus project without opening its editor.
• Import project clones a project from a Git repository.
• Projects lets you search, rename, drag to reorder, and reopen listed projects.
• Learn opens the product documentation.
• System Settings manages general Desktop settings and runtime targets.

In Projects, select a project to enter its AI conversations or choose Open editor. Rename project changes only the list label, while Remove project removes only the list record. Neither action changes the directory, .the file, or project document. Projects and the AI sessions shown under an expanded project can both be reordered by dragging.

Use the file side panel button at the top right of App Hub to open a viewer. File content initially takes 40% of the workspace, with a draggable divider between it and the conversation. The viewer places file content on the left and a resource browser on the far right. Bottom tabs switch between pages, flows, Manual, and Files, with Files selected initially. Pages and flows show resource lists; Manual lists files under manual/; Files retains the directory tree. Filter any category by name or path and select a resource to open it in the viewer. The folder button beside the path toggles the resource browser. Ordinary UTF-8 text supports read-only highlighting, line numbers, and scrolling, with a tab for each open file. Switch, drag to reorder, or close tabs individually. Pressing a tab displays its file before dragging, and the file stays selected after the drop; opening the same file again selects its existing tab and scrolls it into view. Pages and QG programs have dedicated previews; unsupported files show a preview-unavailable message. Hiding the panel restores the full conversation width and retains file tabs for reopening; switching projects clears it. This viewer has no editing or save actions. Press ⌘W on macOS or Ctrl+W on Windows/Linux to close the active side-panel tab; closing the last tab automatically hides the side panel, and pressing the shortcut again closes the window. Use ⌘⇧W / Ctrl+Shift+W to close the App Hub window.

Main editor areas

The editor tab bar and both sidebar headers share the same height, with aligned bottom dividers.

Every editor window belongs to one project. To edit several projects at once, open a separate editor window for each project from App Hub.

The main editor areas are:

• Resources: Pages, Components, Objects, Scripts, Vision, Safety, Assets, and other project resources
• Files: files organized by project path
• Git: changed files and version-control features
• Settings: General, Variables, Queries, I18n, Users / Roles, and enabled-module settings
• Work area: tabs for Pages, QG, Safety, Vision, and text files
• Properties: editable properties for the selected content
• Problems / Console: check results and operation messages
• AI Command Center: AI inspection and project editing for the current App

Some editing capabilities may still be preparing when a project first opens. Files, Git, source, and Settings are available first; Design, Flow, or completion becomes available when preparation finishes.

The native application menu groups commands under File, Edit, View, Run, Window, and Help. Run contains Build, Run, Debug, Continue, Stop, and Runtime target actions without implicitly combining Build and Run.

Return to App Hub

Select Return to App Hub from File. You can also select the App name in the upper-left corner and choose the same action from the App menu. To show App Hub without closing the current editor, select Show App Hub from Window.

If the window has an unsaved draft, file conflict, or deleted source, Leave editor? appears. Back closes the window and discards that unsaved state; Cancel keeps the editor open. This confirmation does not save for you.

Understand the three Page modes

After opening a Page, switch among Design / Preview / Source:

Mode	Purpose
Design	Arrange the layout, select Components, and inspect properties in Properties
Preview	Interact directly; real calls require Run / Debug and failures appear in Console
Source	View and edit Page source, and handle feedback for the current document

Design supports viewing, editing, and basic interaction. Hold Alt to use local controls; Object / Query calls are skipped without logging. Preview supports direct interaction; calls reject in Stopped and log errors to Console, and real calls are allowed after Start / Debug initialization completes.

Design does not require a Runtime deployment. Later chapters explain the complete build, test, and run workflow.

Next step

Continue with the local quickstart, or learn more about the editor workspace.