Editor workspace
An editor window is permanently bound to one exact *.the project. Pages, flows, Git, AI, and runtime actions all belong to that App. Open separate editor windows when working on several Apps at the same time.
Six areas to know
| Area | What it is for |
|---|---|
| Title bar | Confirm the App and runtime target; use Build, Start, Debug, Continue, and Stop; open AI and Properties |
| Resources | Find Pages, Components, Objects, QG, C# Providers, Vision, Safety, and Assets by engineering purpose |
| Files | Inspect the actual workspace tree; create, move, rename, upload, or delete files |
| Versions | Save project versions, sync with the team, and maintain standard/customer versions; Advanced exposes full Git operations |
| WorkArea | Open and split tabs; Pages use Design/Preview/Source and QG uses Flow/Source |
| Properties / Problems / Console | Edit the selection; inspect Build problems; read logs and faults from the current runtime target |
System Settings is at the bottom of the Activity Bar. Use it for the current App's Home Page, modules, packages, Variables, Recipes, Queries, i18n, App users, and related settings.
Choose an entry by task
| Task | Start here |
|---|---|
| Create a Page or Component | Right-click the corresponding group in Resources |
| Create QG or a C# Provider | Right-click Scripts in Resources |
| Create or configure an Object | Objects in Resources |
| Inspect real paths or ordinary configuration files | Files |
| Adjust Page structure and appearance | Page Design and Properties |
| Test Page interaction | Page Preview |
| Inspect or change a QG flow | QG Flow or Source |
| Resolve complete Build problems | Open Problems after Build |
| Read runtime output | Open Console after Start/Debug |
| Ask AI to help with the current App | Title-bar AI button or Cmd/Ctrl+I |
Source is the final source for Pages, Components, and QG. Design and Flow update the same source; they do not create another project format that must be synchronized by hand.
Open, select, and edit
- Double-click a resource in Resources to open it in WorkArea.
- Select the target on the canvas, in Flow, or in Resources.
- Change supported fields in Properties.
- Save, reselect the target, and confirm the displayed value.
- For runtime validation, confirm the title-bar target before selecting Preview, Build, Start, or Debug.
The Design grid, selection boxes, and guides are editor-only and never appear on a runtime page. To edit inside an App Component, double-click the instance and open its .qpc file. Do not copy reusable internals back into every Page.
Save and external changes
- Use
Cmd+Son macOS orCtrl+Son Windows/Linux to save the current tab. - Build reads only files saved to disk. If an open document is unsaved, conflicted, or deleted, the editor warns first; continuing still Builds the disk version.
- When AI, Git, or another editor changes a file without a local draft, the open tab refreshes.
- When the same file has both a local draft and an external change, the editor preserves the draft and reports a conflict. Compare before saving or reloading from disk.
- Closing a changed/conflicted tab, closing the editor, or returning to App Hub asks for confirmation.
- Save changes workspace source only. It does not replace the running App.
Preview, Build, and runtime actions
| Action | What it verifies | Remember |
|---|---|---|
| Design | Page/Component layout and properties | Does not perform real Object calls |
| Preview | Current Page interaction and rendering | Never Builds/Deploys; Object calls may affect the current target |
| Build Debug | Complete diagnostics and QG source breakpoints | Uses saved project files and delivers to the current target |
| Build Release | Optimized delivery candidate | Still requires Start and field acceptance |
| Start | Normal execution of the deployed version | If a Build is missing, the editor asks before Build and continue |
| Debug | Breakpoints, logs, state, and fault paths | Still performs real equipment actions |
Source changes never hot-replace a running instance. Use Stop → Save → Build → Start/Debug to apply new logic.
Problems and Console
- Inline editor diagnostics describe syntax, type, and completion issues in the current open document.
- Problems is the latest complete Build snapshot for all saved project files. Saving a project file clears the old snapshot until the next Build.
- Console shows logs and fault summaries from the selected runtime target during Start/Debug.
Problems and Console can be passed to AI as read-only analysis context. Selecting analysis does not modify the App by itself; review the diagnosis and proposed scope first.
Common shortcuts
| Action | macOS | Windows / Linux |
|---|---|---|
| Save | Cmd+S | Ctrl+S |
| Close current tab | Cmd+W | Ctrl+W or Ctrl+F4 |
| Next / previous tab | Ctrl+Tab / Ctrl+Shift+Tab | Same |
| Tab 1–8 | Cmd+1–8 | Ctrl+1–8 |
| Last tab | Cmd+9 | Ctrl+9 |
| Open or close AI | Cmd+I | Ctrl+I |
Minimum acceptance for one edit
- The tab has no unsaved or conflict state.
- Resources, Source, and Properties agree on the resource and key fields.
- The current document has no live error that blocks progress.
- Problems has no Build error that blocks runtime use.
- The title bar is bound to the intended runtime target.
- Preview, Start, or Debug covers expected success, failure, and recovery behavior.
- For real equipment, field feedback and independent safety measures are confirmed.