App Builder turns a workflow into a custom Mini App. You place widgets on a canvas, bind them to workflow inputs and outputs, and publish the app document onto the workflow.
What it does
- Builds a structured app document with inputs, actions, display widgets, and layout blocks.
- Binds widgets to existing Input and Output node names.
- Runs the workflow from buttons or change events.
- Streams workflow outputs into bound display widgets.
- Saves the app document with the workflow and serves it in Mini App mode.
Open App Builder
- Open a workflow.
- Switch the tab to App mode.
- Click App Builder in the tab bar.
The builder opens at /app-builder/:workflowId.
Build an app
- Add Input nodes and Output nodes to the workflow first. Their
namefields are the binding keys. - Add input widgets such as Text Input, Number Input, Slider, Switch, or Select.
- Set each input widget’s binding to the matching Input node name.
- Add a Button with the Run workflow action.
- Add display widgets such as Text, Markdown, Image, JSON, or Progress.
- Set each display widget’s binding to the matching Output node name.
- Click Publish.
Agent-assisted editing
Click Ask Agent in App Builder to open the builder agent. It can inspect the workflow, add widgets, set bindings, and update the workflow graph when an app needs new Input, Output, or Variable nodes.
Good prompts name the result you want:
Build a compact app for this workflow with all inputs on the left, a run button below them, and outputs on the right.
Bindings
Bindings must match workflow state exactly:
| Widget kind | Bind to |
|---|---|
| Input widgets | Input node name |
| Display widgets | Output node name |
| State controls | Variable node name |
If a binding does not match a node name, the widget has no data to read or write.
Mini App mode
Mini App mode renders the App Builder document when one exists. If a workflow has no app document, NodeTool renders the generated input/output form.