The Module Builder page is where Creators build and edit modules in the Unqork platform. Each module controls the user interface, business logic, and data behavior for one screen or process in the application.
The page has five panels arranged from left to right: the Build Agent, the Component Tray, the canvas (the primary editing area), the Component Properties panel, and the Explorer. All panels except the canvas are collapsible and resizable by dragging their dividers.
Left Panel
The left panel displays the Build Agent panel, where Creators interact with the Build Agent to assign tasks, review plans, and track progress. See Build Agent for the full reference.
Canvas
The center canvas displays the active view of the module and is split into three sub-panels. The tab bar above the canvas tracks open modules and pages. See Navigating the Unqork Platform for tab management options including pin, close group, and keyboard shortcuts.
Canvas Toolbar
The canvas toolbar sits above the component list and provides controls for the active view. The following controls are available in Config View:
| Control | Description |
|---|---|
| Filters the component list by name. | |
| Toggles a visual preview of component contents inside each row on the canvas. | |
| Orders the component list. Options: Default (insertion order), By Type (grouped by component type), and Alphabetical. | |
| Reverts the most recent change to the canvas. | |
| Reapplies the most recently undone change. |
In UI View and Logic View, the toolbar also includes a Direct Select toggle for lasso selection and zoom controls.
Component Tray
The left sub-panel of the canvas lists all available components organized by library. Use the Components tab to browse and drag components into the canvas. Use the Outline tab to see the module's structural hierarchy. In UI View and Logic View, the tray displays view-specific tools instead of the component library. See UI View and Logic View for details.
The tray includes a search bar for filtering by component name, and a library selector drop-down with the following options:
| Option | Description |
|---|---|
| Default Library | All available components organized by category. |
| Data Models | Data model field components linked to the workspace. |
| Snippets | Saved component configurations available for reuse. |
Canvas
The center sub-panel is the primary editing area. It displays every component in the module as a list of rows. Selecting a row opens that component's settings in the Properties panel. The canvas is the only sub-panel that cannot be collapsed.
Component Properties
The right sub-panel of the canvas displays the Properties panel for the component currently selected. When no component is selected, the panel is empty.
The selected component's name displays in a header row with three icons:
| Action | Description |
|---|---|
| Assign labels to the component for categorization and search. | |
| Add a comment or description to the component for team reference. | |
| Opens a menu with Copy Settings, Paste Settings, Pin, Collapse All, and Permissions. |
For a full reference of all component settings, see Component General Settings.
View Toggler
The View Toggler is a set of three buttons in the canvas toolbar, to the left of the search bar. Selecting a button switches the active view between Config View, UI View, and Logic View.
| View | What it displays |
|---|---|
| Config View | The canvas and component tray for adding and arranging all components. Config View is the default view when opening a module. |
| UI View | A live preview of the module as it displays to end-users. |
| Logic View | A canvas for building logic components that process data and actions. |
Switching views does not reload the canvas or lose unsaved changes.
Module Header
The module header runs across the top of the canvas and remains constant across all views.
| Control | Description |
|---|---|
| Definition | Opens a drop-down with module-level tools: Tests, Transforms, Translations, and History. |
| Last saved | Displays when the module was last saved and by whom (for example, "Last saved 2 minutes ago by Alex"). When another Creator has the module locked, this area displays a lock icon and the name of the lock owner instead. |
| A drop-down that sets the current mode. Select Editing to enable editing, or select Viewing to disable editing and interact with the module as end-users would. | |
| Save | Saves the current state of the module (). The drop-down includes Update and Save and Save as Snippet. |
| Opens a menu of module-level actions. See Module Actions below. |
Module Actions
The (ellipsis) menu in the module header contains module-level actions.
| Action | Description |
|---|---|
| Opens the module in Express View for testing in a new browser tab. | |
| Scans the module for accessibility issues like missing labels, insufficient color contrast, and keyboard navigation gaps. Results display inline. | |
| Manage the module definition. Includes the following: Copy Module, Paste at Top, Paste at Bottom, Replace All, Duplicate, Rename, Export, and Import. | |
| Module name, description, type, and configuration. | |
| Reverts the most recent change to the module. | |
| Reapplies the most recently undone change. | |
| Adds the module to the Build Agent's context for the current session. Displays as Remove from Agent Context when already in context. Removing it prevents the Agent from using the module's configuration when generating code or answering questions. | |
| Stars the module for quick access from the workspace switcher. | |
| Opens the module comments panel. | |
| Promotes components to the Smart Component Library. | |
| Removes all components from the module. This action cannot be undone. | |
| Permanently deletes the module from the application. This action cannot be undone. Not available for entrypoint modules. |
Definition Drop-Down
The Definition button in the module header opens a drop-down with module-level tools and configuration panels. The drop-down includes the following tools:
| Tool | Description |
|---|---|
| Definition | Return to the module canvas and switch between Config View, UI View, and Logic View. |
| Tests | Test cases Creators can run against the module. |
| Transforms | Data transformations applied when the module runs. |
| Translations | Localization strings for multi-language support. |
| History | View and restore previous versions of the module. |
Right Panel
The right panel displays the Explorer, the workspace file tree for opening modules, workflows, and data collections. See Explorer for the full reference.
Changelog
| Date | Change |
|---|---|
| 2026-08-21 | Module Actions: Preview and Preview with App Context replaced by the View in Express fly-out (In App / Module Only) (UQE-17425). |
| 2026-07-31 | Added full-layout screenshot; icon columns merged inline; ellipsis menu updated with Add to Agent Context, Favorite, and Accessibility Check (EN-7982). |
| 2026-07-30 | Code sweep (EN-7982): View Toggler order corrected to Config→UI→Logic; Config View icon fixed; View in App removed from header (now Preview/Preview with App Context in ellipsis); Settings removed from Definition Drop-Down (it is in the ellipsis menu); ellipsis menu updated with full action list. |
| 2026-07-30 | Left panel: replaced "Qobi" with "Build Agent"; removed "manage a knowledge base" (EN-7982). |
| 2026-07-20 | Updated interactive image to the new five-panel Module Builder layout. Updated documentation to match: Agent Chat in the left panel; Component Tray, Component Tree, and Component Properties as three canvas sub-panels; Explore in the right panel. |
| 2026-07-07 | Added interactive image with clickable hotspots for Left Panel, Canvas, and Right Panel. Promoted Left Panel, Canvas, and Right Panel to top-level sections; moved View Toggler and Module Header under Canvas. |
| 2026-06-30 | New hero screenshot (Config View, qa22). Renamed Toolbar → Module Header with correct controls (Definition, Show/Hide Toolbar, Editing/Viewing mode, View in App, Save, ⋮). Module header ⋮ corrected: Update and Save + Save as Snippet (was Module History/Snippets/Service Logs). Definition drop-down: Debugger → History. Right Panel corrected to File Explorer. Properties panel: added Collapse All, removed Component Docs; More now shows Permissions only. Left Panel simplified to Agent Chat cross-reference. Canvas updated with view-article cross-references. Definition Drop-Down section renamed from Tools Drop-Down. |
| 2026-06-30 | Config View is the default view when opening a module (UQE-15861). |
| 2026-05-28 | Renamed "Definition Dropdown" → "Tools Drop-down" with corrected links; renamed "View Selector" → "View Toggler"; updated Canvas section and toolbar table to reference View Toggler and Tools Drop-down. |
| 2026-05-22 | Added inline icons for all panels; expanded Understand panel with Components, Deep Dive, and Dependencies sections; expanded Properties panel with full tab and action icon reference. |
| 2026-05-22 | Initial publication. |