Visual Flow Editor

Click the '+ Add step' button at the bottom of the canvas, or press / anywhere on the canvas. The Node Picker opens. The landing screen shows a grid of category tiles plus a Recently Used row. Click a category to drill into a filtered list of nodes in that category. Start typing in the search field to search all categories at once. Click a node to add it below the last step.

Nodes are grouped into 13 categories: FIND (search entities on the canvas by category, type, layer, name, selection, proximity, or all), PLACE (create new plants, shapes, text, or structures), EDIT (move, rotate, scale, delete, hide, show, duplicate, rename, set style, set layer), MEASURE (compute geometry values), LAYERS (manage layers), SELECTION (control canvas selection), OUTPUT (log messages and values), CONTROL (if/else conditions, for loops, while loops), FUNCTION (define and call reusable functions), VARIABLE (local variables, table assignments), OPERATOR (boolean and comparison operators), MATH (math functions), STRING (string functions).

Each node is a flat rectangular card. The card header shows the category label (e.g. FIND) in the category colour and the node sub-label (e.g. 'by category') in muted text. Below the header are the node's inline form fields — you edit them directly on the card. A delete [×] button in the corner removes the node. An error state shows a red (ruby) border when the node caused a runtime error during the last run.

Nodes execute top to bottom. Drag from the output handle at the bottom of one card to the input handle at the top of another to connect them. A '+' button appears at the midpoint of every edge — click it to insert a new node between two existing nodes. Container nodes (if, for, while, function) have a dashed body area where child nodes are nested using child edges.

Click a node to select it. When exactly one node is selected, the Node Inspector slides in from the right edge of the canvas. It shows the node's documentation, a summary of data dependencies (variables in scope), and after a run, a trace of the most recent execution result for that node. Press Esc or click the × to dismiss.

Nodes that produce a result (FIND, PLACE, EDIT with duplicate, VARIABLE locals) store their result in an auto-named variable (e.g. _r1, _r2). Subsequent nodes reference these by typing the variable name into their Entities or other expression fields. The Node Inspector's Dependencies section lists all variables visible at the selected node.

Pan by middle-click drag or two-finger trackpad pan. Zoom with pinch or the toolbar zoom buttons. Fit the whole graph to view with the Fit button. Toggle Pan mode on/off from the toolbar to switch between panning (left-drag pans) and selecting (left-drag creates a selection box). The minimap in the bottom right shows the full graph — click or drag to navigate.

Select multiple nodes and press Ctrl+G to group them into a subflow container. This collapses the nodes into a single card, keeping the canvas tidy for complex automations. Press Ctrl+Shift+G (or select the subflow and use the command) to expand it back into individual nodes.