App Hub and editor tour
Theseus Desktop uses App Hub as the entry point for projects. Opening a project takes it into its own editor window.
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 uses the system file picker to open an existing local Theseus project file.
- Import project clones a project from a Git repository.
- Recent projects lets you search, switch between grid and list views, and reopen projects you have used.
- Learn opens the product documentation.
- System Settings manages general Desktop settings and runtime targets.
In Recent projects, double-click a card, select it and press Enter, select its editor button, or choose Open editor from its context menu. Remove from recent projects removes only the history entry; it does not delete the project directory.
Main editor areas
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, Recipes, 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, Preview, Flow, or completion becomes available when preparation finishes.
Return to App Hub
Select the App name in the upper-left corner, then select Return to App Hub from the App menu.
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 | Check Page presentation and interaction using the current built version |
| Source | View and edit Page source, and handle feedback for the current document |
Design is for editing and does not mean that the App is running. Preview checks actual Page behavior. If the Page calls an Object or equipment capability, those actions can have real effects, so confirm that the project and equipment are in a safe state before previewing.
If Preview reports that a Build is required, save the files and complete Build as prompted. Later chapters explain the complete build, test, and run workflow separately.
Next step
Continue with the local quickstart, or learn more about the editor workspace.