Concepts

Port Types

The seven colours a port can be, which wires Watchflows will let you draw, and why the colour never changes what flows through.

The seven types

Each port declares a type, drawn as its colour: what the node says it produces (an outlet) or expects (an inlet). The type gates which wires you can draw; it never changes what flows through. Most ports are any, so most wires just connect.

TypeColourDeclares
string GreenText
number BlueIntegers and decimals
boolean RedTrue or false
json YellowObjects and arrays
any GrayAnything, in both directions
file PurpleA path on disk
image OrangeAn image
Wires take the colour of the port they leave.
Wires take the colour of the port they leave.

What connects

A wire runs outlet to inlet between two different nodes, and must not close a loop. Matching types connect, any connects to everything, and five mismatches are allowed: string to json, and json, number, boolean or file to string. Anything else snaps back.

Types gate the wire, not the run. Nothing converts a value on the way through — number to string means the wire is legal, not that the number is rewritten.

Emitters wire to a short list. An emitter connects only to Log, Log to File, JSON Viewer, File Log, Time Series and Condition. Put a Condition after it and the rest of the flow opens up again.