ConstructUI
Overview
Overview
ConstructUI is our ecommerce website for production-ready, paid Mendix widgets and components, built to install directly into Studio Pro and deploy straight into live applications. Browse custom Mendix widgets that can be easily ingested into modern React UI frameworks. Explore the full catalogue at https://constructui.com or contact STS for Construct UI Enterprise.
Action menu
ActionMenu adds contextual actions to rows, cards, toolbars, and detail pages. Collapse row and page actions into a compact three-dot menu that keeps your grids and toolbars uncluttered.
Configure any number of actions with icons, captions, and visibility conditions. It reads menu items from a JSON String attribute and can pass the selected action key and target ID to a microflow or nanoflow. Appearance settings support configurable colour, size, background, trigger label, placement, alignment, disabled state, and empty-menu behaviour.
Ready to use ActionMenu in your live app? Get the production-ready edition on ConstructUI → https://constructui.com/widgets/actionmenu
Sortable Grid
SortableGrid helps users view structured work items, reorder rows through drag-and-drop, use paging, and run configured Mendix actions. Let users reorder list items by dragging them directly in the grid, with the new sequence written back to your domain model.
Drag any row to reorder it within its group, the sequence updates instantly, and every column can be filtered to help users find items quickly."
SortableGrid fits any scenario where order matters, task boards, project plans, priority lists, and grouped work items.
Ready to use SortableGrid in your live app? Get the production-ready edition on ConstructUI → https://constructui.com/widgets/sortablegrid
Snipping Tool
Capture, crop, and annotate screenshots without leaving your app, so any feedback or bug reports show exactly what you mean. Snipping Tool lets users grab a full screen, a single window, or a browser tab, then trim the image to the area that matters.
Users capture the issue the moment it happens, crop to what matters, and mark it up with arrows, highlights, or text. The finished image saves straight to your Mendix data.
Use Snipping Tool anywhere users need to show rather than tell. It’s a natural fit for bug reporting, feedback forms, support and service desk portals, UAT and QA testing, and design or content review workflows.
Ready to use Snipping Tool in your live app? Get the production-ready edition on ConstructUI → https://constructui.com/widgets/snippingtool
Image Annotator
Image Annotater lets users add PNG, JPEG, or WebP files, then mark it up right inside your app.
Users start with an image they already have, such as a photo, a mockup, a diagram, or an exported screenshot, and annotate it in a few clicks. They can pick a shape, set the font colour and size, and use undo or delete to fix mistakes as they go.
Use Image Annotater whenever the image already exists and people need to point at something on it. Anywhere a photo, diagram, or drawing needs a quick “look here” before it moves on to the next step.
Ready to use Image Annotator in your live app? Get the production-ready edition on ConstructUI → https://constructui.com/widgets/imageannotator
Contact Information:
Contact Person : Trishant Deva
Contact Number : +2782 429 3654
Contact Email : trishant@stsafrica.com
Documentation
Typical Usage Scenario
ConstructUI helps Mendix teams build polished work-management screens without creating every grid and contextual-action interaction from scratch.
Use SortableGrid for Product Backlogs, Backlog Cards, Challenges, archived items, test data, idea backlogs, and subfeatures. Users can review structured work items, reorder supported rows by drag and drop, use paging, and trigger configured Mendix actions.
Use ActionMenu in a grid row, card, toolbar, or detail page for contextual actions such as View, Edit, Archive, Restore, Duplicate, Move, or Delete.
Use Snipping Tool when users need to capture a screen, application window, or browser tab. They can crop and annotate the captured image before saving it as an attachment associated with a Mendix object.
Use Image Annotator when users already have an image on their device. They can upload, crop, and annotate the image before saving it as an attachment associated with a Mendix object.
These widgets are useful for software delivery, portfolio management, service operations, testing, approval lists, and other Mendix applications that need readable work-item views or visual feedback.
Sortable Grid call microflow on ConstructUIData.ACT_GetGridJson_VAL
Action Menu call microflow on ConstructUIData.DS_InitKebab
Snipping tool open the page on ConstructUIData.TestData_Overview
Image Annotator open the page on ConstructUIData.TestData_Overview_IMG
Features and Limitations
Features
SortableGrid
Showcase modes: Product Backlog, Backlog Card, Challenge, archive, test data, idea backlog, and subfeature.
Drag-and-drop reorder interaction with a configurable Mendix update action.
Paging and configurable initial row count.
Configurable actions for row clicks and common menu actions.
ActionMenu
Standalone ActionMenu with JSON-driven items.
Appearance settings: colour, icon size, button size, background, label, menu width, placement, alignment, disabled state, and empty message.
Item icons: view, edit, archive, restore, delete, duplicate, and move.
Item styles: default, muted, and danger.
Snipping Tool
Captures a screen, application window, or browser tab using the browser’s screen-sharing dialog.
Crops the captured image.
Adds pen drawings, arrows, rectangles, circles, and text.
Supports annotation colours, stroke sizes, selection, moving, deletion, undo, and clear.
Saves the final image as a PNG in a Mendix attachment associated with a parent object.
Provides optional Mendix actions for successful saves and error handling.
Image Annotator
Uploads PNG, JPEG, and WebP images through file selection or drag and drop.
Validates image type, file size, and decoded dimensions.
Crops the uploaded image.
Adds pen drawings, arrows, rectangles, circles, and text.
Supports annotation colours, stroke sizes, selection, moving, deletion, undo, clear, and reverting to the uploaded image.
Saves the final image as a PNG in a Mendix attachment associated with a parent object.
Provides optional Mendix actions for successful saves and error handling.
Limitations
SortableGrid and ActionMenu
The Marketplace edition is a curated Showcase component, not an arbitrary dynamic JSON grid engine.
SortableGrid columns and row layouts are fixed to the supported Showcase modes.
Drag-and-drop changes must be persisted by the configured Mendix microflow or nanoflow.
Dynamic columns, badge rules, custom icons, validation, and arbitrary JSON schemas require ConstructUI Enterprise.
Web only; not intended for Mendix Native mobile applications.
Snipping Tool and Image Annotator
Snipping Tool captures the screen; it does not upload an existing local image. Use Image Annotator for uploaded images.
Image Annotator uploads images; it does not capture the screen.
Snipping Tool requires browser support for screen capture and the user’s permission to share the selected screen, window, or tab.
The final image is saved as a flattened PNG. Existing annotations cannot be individually selected or edited after they have been merged into the image.
Image Annotator’s default limits are 10 MB per source file and 12,000 pixels for either decoded image dimension. These limits can be configured.
Both widgets require a valid parent object and an attachment entity that specializes
System.FileDocument.Both widgets are intended for Mendix Web applications.
Dependencies
No external library installation is required. The STS-owned stsdndkit library is bundled inside ConstructUI.
SortableGrid and ActionMenu require a Mendix Web application and a Data View context that provides the configured attributes.
Snipping Tool and Image Annotator require:
A Mendix Web application.
A parent object supplied through the configured data source.
An attachment entity that specializes
System.FileDocument.An association from the attachment entity to the parent object.
Appropriate entity, association, and action permissions for the user’s role.
The enterprise editions of Snipping Tool and Image Annotator also use ConstructUIData.DS_GetEnterpriseLicenseStatus. Users who can open the widgets need permission to execute this microflow.
Installation
Download and import the appropriate ConstructUI Marketplace module or widget packages.
Synchronise the project and open the required page.
Add a Data View that supplies a context object where needed.
Add SortableGrid, ActionMenu, Snipping Tool, or Image Annotator from the Add-ons toolbox.
Configure the required attributes, data sources, associations, and actions.
Check the applicable security permissions, then run the application.
Configuration
SortableGrid
Place SortableGrid inside a Data View. Create or use a context entity with:
ListJson: String attribute containing supported SortableGrid JSON.ReturnJson: String attribute receiving the updated JSON result.Optional
ListId: Integer attribute for selected list items.Optional
ChallengeId: Integer attribute for selected challenges.
Select the required Display Mode. Map List Json to ListJson and The return Json to ReturnJson. Configure Update Position to persist drag-and-drop reordering. Configure optional row, card, challenge, and menu actions as needed.
ActionMenu
Place ActionMenu inside a Data View. Create or use a context entity with:
ItemsJson: String attribute containing menu JSON.SelectedActionKey: String attribute.Optional
SelectedTargetId: String attribute.
Map these attributes in the widget properties. Configure Selected item action with a microflow or nanoflow receiving the current Data View object. In the flow, read SelectedActionKey and SelectedTargetId to determine the business action.
{ "items": [ { "id": "edit-feature", "label": "Edit feature", "actionKey": "edit", "targetId": "123", "iconKey": "edit", "order": 10 }, { "id": "delete-feature", "label": "Delete feature", "actionKey": "delete", "targetId": "123", "iconKey": "delete", "itemStyle": "danger", "order": 20 } ] }
Snipping Tool
Add the widget to the page and configure Parent Object with a data source that returns the object to which the capture will be attached.
Set Attachment Entity Name to the fully qualified name of a
System.FileDocumentspecialization, for exampleTestingTool.Attachment.Set Association Name to the fully qualified association from the attachment to the parent object, for example
TestingTool.Attachment_Defect.Configure the optional actions for save success, save failure, upload failure, capture failure, and a missing parent object.
For the enterprise edition, configure the licence-status integration and grant the relevant user roles permission to execute
ConstructUIData.DS_GetEnterpriseLicenseStatus.
When the user saves a capture, the widget creates an attachment, associates it with the parent object, and saves the PNG.
Image Annotator
Add the widget to the page and configure Parent Object with a data source that returns the object to which the image will be attached.
Set Attachment Entity Name to the fully qualified name of a
System.FileDocumentspecialization, for exampleTestingTool.Attachment.Set Association Name to the fully qualified association from the attachment to the parent object, for example
TestingTool.Attachment_Defect.Configure the accepted image types, maximum file size, and maximum image dimension as required.
Configure the optional actions for save success, save failure, upload failure, file validation failure, and a missing parent object.
For the enterprise edition, configure the licence-status integration and grant the relevant user roles permission to execute
ConstructUIData.DS_GetEnterpriseLicenseStatus.
When the user saves an image, the widget creates an attachment, associates it with the parent object, and saves the edited PNG.
Enterprise Licence and Registration
Snipping Tool and Image Annotator check their licence statuses independently. A valid licence displays no licence banner or registration form.
When a licence needs attention or its status is unavailable, the widget displays a message while remaining usable. It may check whether the current user is already registered using an available session email address. If no registration is found, or the check cannot be completed, a registration form can appear.
The form asks for the user’s name, email, company, phone number, and consent. The email is checked again before creating a registration to reduce duplicates. Not now closes the form without creating a registration; the form can appear again on a later page visit. An automatic email lookup may already have occurred before the user selects Not now.
Licence keys and API tokens must remain in protected server-side configuration. The browser’s content-security policy must allow connections to https://constructui.com for the registration flow.
Known Bugs
No known reproducible defects in version 1.3.0 of the documented SortableGrid and ActionMenu Marketplace edition.
For Snipping Tool and Image Annotator, verify the installed widget version and the project’s current release notes for known issues.
Frequently Asked Questions
Can I use SortableGrid and ActionMenu separately?
Yes. Both are included in ConstructUI and can be placed independently.
Does ActionMenu overwrite ItemsJson after selection?
No. It writes only the selected action key and optional target ID.
Does the selected-action flow need String parameters?
No. Configure it with the current Data View object, then read its selected-action attributes.
Does SortableGrid automatically save a drag-and-drop order?
No. Configure SortableGrid’s Update Position action to save the returned order in Mendix.
Can ConstructUI Marketplace render any JSON structure?
No. ConstructUI Enterprise is required for arbitrary JSON-driven grids, dynamic columns, badge and icon rules, and customer-specific configuration.
What is the difference between Snipping Tool and Image Annotator?
Snipping Tool captures a screen, window, or browser tab. Image Annotator starts with an image uploaded from the user’s device.
What types of images can Image Annotator upload?
By default, it accepts PNG, JPEG, and WebP images. The accepted types and size limits can be configured.
Where are the images saved?
Each widget saves the final PNG in the configured Mendix attachment entity and associates it with the configured parent object.
Can users edit an annotation after saving the image?
The saved image is a flattened PNG, so its existing arrows, shapes, and text cannot be selected and edited individually.
What happens if the user chooses Not now on the registration form?
The form closes without creating a registration. It may appear again on a later page visit. An automatic email lookup may already have occurred before the user selects Not now.
Releases
Sortable Grid call microflow on ConstructUIData.ACT_GetGridJson_VAL
Action Menu call microflow on ConstructUIData.DS_InitKebab
Snipping tool open the page on ConstructUIData.TestData_Overview
Image Annotator open the page on ConstructUIData.TestData_Overview_IMG
- Snipping Tool will use ConstructUIData.TestData_Overview page
- Image Annotator will use ConstructUIData.TestData_Overview_IMG