Nodes and Edges

Flows are built from two things: nodes and edges.

Nodes

A node is a single unit of work. Each node does one specific thing — listening for an event, checking a condition, transforming data, or performing an action.

Every node belongs to one of five categories:

Category	Purpose	Example
Trigger	Starts the flow when something happens	Chat Command, Subscription, Raid
Check	Makes a decision and branches the flow	Is Moderator, String Check, Cooldown
Process	Transforms or manipulates data	Math, String Op, Generate Text
Effect	Performs an action (end of the line)	Send Chat Message, Switch OBS Scene
Data	Provides a value to the flow	Text Data, Random, Flow Variable

Handles

Nodes have handles — small circles on their left and right sides:

• Input handles (left side) receive data from other nodes
• Output handles (right side) send data to other nodes

Trigger nodes only have output handles (they produce data but don't receive it). Effect nodes only have input handles (they consume data but don't pass it along). Check, Process, and Data nodes can have both.

Edges

An edge is a connection between two nodes. It carries data from one node's output handle to another node's input handle.

To create an edge:

1. Click on an output handle
2. Drag to an input handle on another node
3. Release to create the connection

Connection Rules

Not all handles can be connected. The editor enforces these rules:

• Type compatibility — The output type must be compatible with the input type. For example, you can connect a string output to a string input, but not a number output to a User input.
• No self-connections — A node cannot connect to itself.
• No backwards connections — Edges must flow from outputs to inputs, never the other direction.
• No cycles — You cannot create circular connections (A connects to B connects to A). The editor will prevent this.

Inputs that accept any type will work with any output type.

Adding Nodes

There are several ways to add nodes to your flow:

• Right-click the canvas to open the context menu
• Press Ctrl+Space to open the node autocomplete picker
• Drag from the toolbar to add a node directly

The autocomplete picker lets you search for nodes by name and shows a brief description of each one.