When to use it. An Obsidian-style force-directed graph visualization. Displays nodes and edges with physics simulation, glow effects, and interactive pan/zoom/drag. Read-only (display), optionally interactive.
Type
graph
Also titled
Graph
Default size
4 rows × 4 columns
Symbol
circle.grid.cross.fill
Docs
Docs complete
Search for it as
network
nodes
edges
diagram
relationships
links
Rendered by the app
Fields
34 fields you can set on a graph control. Every control also takes the shared fields (id, position, span, sync, action).
Fields
Field
Type
Default
What it does
Titlelabel
text
—
The name shown above the graph
Shows this text as the header above the graph in the label font size (8-24 pt).
graphConfiggraphConfig
object
—
All the graph's look and behavior in one bundle
Holds every graph setting below; any setting left out uses its default.
Colortint
color
#667eea
The standby color for the dots
Colors the nodes with this hex color when graphConfig sets no node color.
attractionForcegraphConfig.attractionForce
number
0.01
How tightly linked dots hug each other
Pulls connected nodes closer together; 0.01 is gentle and larger values draw linked dots into tight clusters.
BackgroundgraphConfig.backgroundColor
color
—
The backdrop behind the network
Fills the graph canvas with this hex color; the default is a near-black navy.
centerForcegraphConfig.centerForce
number
0.02
How strongly the network gathers in the middle
Pulls every node toward the canvas center; 0.02 keeps it loose and larger values squeeze the cloud into the middle.
contentEventgraphConfig.contentEvent
text
—
Not used yet
Reserved for a future content-push feature, so setting it changes nothing on screen.
dampinggraphConfig.damping
number0–1step 0.05
0.9
How quickly the dots stop moving
Scales motion each tick from 0 to 1; lower values add friction so the dots stop sooner.
draggablegraphConfig.draggable
on / off
true(on)
Whether a dot can be pulled around
On lets a finger drag a single node and the rest follow; off keeps every dot where physics puts it.
Line colorgraphConfig.edgeColor
color
—
The color of the connecting lines
Colors every line between nodes with this hex color unless an edge sets its own.
Curved linesgraphConfig.edgeCurved
on / off
false(off)
Straight or bowed connections
On bends each line into a gentle curve; off draws straight lines.
Line fadegraphConfig.edgeOpacity
number0–1step 0.05
0.4
How faint the lines are
Sets line opacity from 0 (invisible) to 1 (solid); the default 0.4 keeps lines soft.
Line widthgraphConfig.edgeWidth
number0.5–12 ptstep 0.5
1.0
How thick the lines are
Sets the line thickness in points, 0.5 to 12; an edge can override it.
glowColorgraphConfig.glowColor
color
—
The color of the halo around dots
Tints the glow behind nodes with this hex color; it only shows while glow is on.
GlowgraphConfig.glowEnabled
on / off
true(on)
A soft halo behind each dot
On draws a blurred glow behind every node; off leaves flat dots.
GlowgraphConfig.glowRadius
number0–30 ptstep 1
6.0
How wide the halo spreads
Sets the glow blur in points, 0 to 30; larger values spread a softer, wider halo.
groupColorsgraphConfig.groupColors
object
—
A color for each kind of dot
Maps group names to hex colors so nodes whose group matches are filled with that color.
interactivegraphConfig.interactive
on / off
true(on)
Whether you can pan and zoom
On lets a drag move the canvas and a pinch zoom it; off freezes the view.
labelColorgraphConfig.labelColor
color
—
The color of the dot names
Colors the text under each node with this hex color.
labelOffsetgraphConfig.labelOffset
number0–40step 1
12.0
How far the name sits from its dot
Moves each label this many points away from its node center, 0 to 40.
Label sizegraphConfig.labelSize
number8–24step 1
10.0
How big the dot names are
Sets the node label font size in points, 8 to 24.
nodeActiongraphConfig.nodeAction
object
—
What happens when you tap a dot
Runs this action when any node is tapped, with the node id available as {{value}}; a node's own onTap wins.
nodeBorderColorgraphConfig.nodeBorderColor
color
—
The color of the ring around each dot
Colors the outline drawn around nodes; it only shows when the outline width is above 0.
Node outlinegraphConfig.nodeBorderWidth
number0–5step 0.5
0
A ring around each dot
Draws an outline of this thickness in points, 0 to 5; 0 means no outline.
Node colorgraphConfig.nodeColor
color
—
The default fill of the dots
Fills every node with this hex color unless its group or its own color overrides it.
nodeHighlightColorgraphConfig.nodeHighlightColor
color
—
The color of the dot you touch
Switches a node to this hex color while it is active or selected.
Node sizegraphConfig.nodeSize
number2–40 ptstep 1
8.0
How big the dots are
Sets the base node radius in points, 2 to 40; a node's size multiplier scales it.
particleColorgraphConfig.particleColor
color
—
Not used yet
Reserved for the particle color, so setting it changes nothing on screen.
particleSpeedgraphConfig.particleSpeed
number
—
Not used yet
Reserved for the particle speed, so setting it changes nothing on screen.
repulsionForcegraphConfig.repulsionForce
number
100
How hard the dots push each other away
Pushes every pair of nodes apart; larger values spread the network out and smaller ones pack it tight.
LabelsgraphConfig.showLabels
on / off
true(on)
Names under the dots
On writes each node's label under it; off shows bare dots.
ParticlesgraphConfig.showParticles
on / off
false(off)
Little lights traveling along the lines
On animates small particles running along the edges; off leaves the lines still.
velocityDecaygraphConfig.velocityDecay
number0–1step 0.05
0.6
How fast the network settles
Sets how quickly dot speed fades, 0 to 1; lower values let the layout come to rest sooner.
zoomRangegraphConfig.zoomRange
object
—
How far you can zoom out and in
Sets the smallest and largest pinch zoom as [min, max], default [0.3, 3.0].
Emits and receives
What this control sends when you use it, and what it can show or follow when data arrives.
Emits
Emits
Sends
When
Type
What it sends
When you tap a nodenode
tap
id
the id of the node you tapped
A node's own tap behavior wins over this action
Example: Item 1
Receives
Receives
Takes
From
Type
What it does
nodesshow
hub, mqtt, http, store, default
json
nodes, each with an id and an optional label, group, color and size, and edges joining two node ids
the layout settles with the new nodes and lines; nodes that are gone fade out
Demonstrates glowEnabled, showParticles, nodeBorderWidth and nodeHighlightColor: dots lose their halo, get a white ring, and small lights travel along the lines.
Demonstrates groupColors, repulsionForce, attractionForce and centerForce: nodes take their group's color and the layout spreads wide but stays centered.
route_msg_noreply resolves the hub by its registered name and delivers a select_device
frame to it. (route_msg would need the hub's live relay-assigned target_id, not a name.)
Content — requests markdown content from the server and opens it in a scrollable markdown sheet.
event is sent verbatim as the frame type and the reply is awaited, so it must be route_msg
(the only relay verb that carries a reply back) aimed at the server's live relay-assigned
target_id; the relay delivers the inner payload to that peer as a get_doc request.
A name is not resolved here, so this suits layouts a server generates after it connects: