A pulse is a decorative ring that flashes around a container the moment live data lands on it — a zero-wiring way to *see* events arriving. The ring expands outward (data collected / leaving) or contracts inward (data arriving / stored), with a brief glow along the resting border, then fades. It never intercepts touches and is invisible at rest.
Symbol
dot.radiowaves.left.and.right
Docs
Docs complete
Fields
7 fields, each with what it does.
Fields
Field
Type
Default
What it does
eventevent
text
—
Which server event triggers it
Makes the ring flash each time this socket event arrives, such as broadcast.
colorcolor
color
#34C759
Ring color
Colors the flashing ring and the glow along the border (default green).
directiondirection
choiceone of 2
outward
Which way the ring moves
Makes the ring either grow away from the group or shrink toward it.
outwarddefaultthe ring expands away from the group, as if data is leaving or collected
inwardthe ring contracts toward the group, as if data is arriving or stored
spreadspread
number0–1step 0.05
0.1
How far the ring travels
Sets how far the ring moves as a fraction of the group's size, 0 to 1 (default 0.1 is 10%).
durationduration
number0.1–10step 0.1
0.9
How long one pulse lasts
Sets the pulse length in seconds, from 0.1 to 10 (default 0.9).
curvecurve
choiceone of 5
gentle
How the ring eases
Picks the easing of the ring's motion; the springy presets make it overshoot slightly.
snappyquick with a crisp stop
smoothan even natural glide
bouncyovershoots and settles
gentledefaulta calm slow ease (the default)
instantno easing, it jumps straight through
filterfilter
object
—
Only pulse for matching data
Limits the pulse to events whose payload contains these key/value pairs, so other events are ignored.
Examples
3 examples, each one a control you can paste into a layout.
Use the preview above to tune the colour, direction, ring width,
curve, spread, and duration, then tap Fire Pulse — or flip
Auto Pulse to watch it repeat as though readings were streaming in. The
curve reuses the app's animation presets: gentle is a calm
ease, while bouncy/smooth/snappy give the ring a springy overshoot.
On a group
Attach a pulse to any group and it flashes whenever its event
arrives over the socket. An optional filter narrows which payloads count,
matching keys the same way a Sync filter does.
In the app
The Location Metrics screen uses the same effect directly: the live-payload
card pulses green outward each time a reading is collected, and the buffer card
pulses inward each time the queue is flushed to the server.