Sinua
Catalog

Beacon

Status in place: a ping, connection quality, location accuracy, a radar scan or a broadcast.

The beacon shows status in place: a notification ping, connection quality, location accuracy, a radar scan or a broadcast.

See every beacon pattern live

When to use which pattern

PatternpatternWhen to use it
NotifyingnotifyingSomething happened: a ping ripple (can play once).
ReconnectingreconnectingConnection quality: a pulse with lit segments.
LocatinglocatingPosition with uncertainty: a halo that shrinks as accuracy rises.
ScanningscanningScanning an area: a radar sweep with blips.
BroadcastingbroadcastingSending out: waves from a centre, driven by level.

Props

Every prop, per pattern. Values are your app's data; everything else is style. Defaults can differ per size (20 · 32 · 64).

The beacon component is SinuaBeacon. Pick a look with pattern; each pattern reads the props below. Sizes are engine sizes (20, 32, 64): defaults can differ per size.

PatternModeSpeedValues (app data)
Notifying (notifying)ping1×once
Reconnecting (reconnecting)pulse1×quality
Locating (locating)halo1×accuracy
Scanning (scanning)radar1×—
Broadcasting (broadcasting)broadcast1×level

Notifying

pattern: "notifying" · mode ping · speed 1× · sizes 20, 32, 64

PropCategoryTypeRangeDefaultDescription
dotSizeAppearancenumber0.01–0.4 (UI 0.04–0.25) fraction0.12Centre dot radius as a fraction of the frame.
hueAppearancenumber0–360 deg200Ink hue in degrees; applies once saturation is above 0.
inkAppearancenumber0–1 fraction1How present the whole visual is: 1 draws it as the pattern defines it, lower fades everything including its halos. A voice assistant rests below 1 when idle and comes to full ink when it listens.
ringCountAppearanceinteger1–42Ripples per ping.
saturationAppearancenumber0–1 fraction0How far the ink moves from grey toward the hue (0 = the grey ink).
periodMotionnumber0.05–30 (UI 0.4–3) s1Seconds between pings.
onceInputsboolean0Play one ripple and stop (restart the clock to replay).
Advanced props (2)
PropCategoryTypeRangeDefaultDescription
ringReachAppearancenumber0.05–0.5 fraction0.41How far the ripples travel, as a fraction of the frame.
ringWidthAppearancenumber0.005–0.2 fraction0.03Ripple stroke width as a fraction of the frame.

Reconnecting

pattern: "reconnecting" · mode pulse · speed 1× · sizes 20, 32, 64

PropCategoryTypeRangeDefaultDescription
dotSizeAppearancenumber0.01–0.4 (UI 0.04–0.25) fraction0.12Centre dot radius as a fraction of the frame.
hueAppearancenumber0–360 deg200Ink hue in degrees; applies once saturation is above 0.
inkAppearancenumber0–1 fraction1How present the whole visual is: 1 draws it as the pattern defines it, lower fades everything including its halos. A voice assistant rests below 1 when idle and comes to full ink when it listens.
saturationAppearancenumber0–1 fraction0How far the ink moves from grey toward the hue (0 = the grey ink).
qualityInputsnumber0–1 fraction0Connection quality 0 to 1: lit segments and a calmer pulse as it rises.
Advanced props (4)
PropCategoryTypeRangeDefaultDescription
segmentGapAppearancenumber0–60 deg14Gap between quality segments, in degrees.
segmentRadiusAppearancenumber0.05–0.5 fraction0.3Radius of the quality arc as a fraction of the frame.
segmentWidthAppearancenumber0.005–0.2 fraction0.04Stroke width of the quality segments.
periodMotionnumber0.05–30 s2Seconds per pulse.

Locating

pattern: "locating" · mode halo · speed 1× · sizes 20, 32, 64

PropCategoryTypeRangeDefaultDescription
dotSizeAppearancenumber0.01–0.4 (UI 0.04–0.25) fraction0.1Centre dot radius as a fraction of the frame.
hueAppearancenumber0–360 deg200Ink hue in degrees; applies once saturation is above 0.
inkAppearancenumber0–1 fraction1How present the whole visual is: 1 draws it as the pattern defines it, lower fades everything including its halos. A voice assistant rests below 1 when idle and comes to full ink when it listens.
saturationAppearancenumber0–1 fraction0How far the ink moves from grey toward the hue (0 = the grey ink).
accuracyInputsnumber0–1 fraction0.5Location accuracy 0 to 1: the halo shrinks as it rises.
Advanced props (3)
PropCategoryTypeRangeDefaultDescription
haloOpacityAppearancenumber0–1 fraction0.14Opacity of the accuracy halo.
ringWidthAppearancenumber0.005–0.2 fraction0.025Halo edge stroke width as a fraction of the frame.
periodMotionnumber0.05–30 s2Seconds per halo breath.

Scanning

pattern: "scanning" · mode radar · speed 1× · sizes 20, 32, 64

PropCategoryTypeRangeDefaultDescription
blipCountAppearanceinteger0–123Contacts that light up as the sweep passes.
dotSizeAppearancenumber0.004–0.08 (UI 0.008–0.05) fraction0.018Scope dot radius as a fraction of the frame.
hueAppearancenumber0–360 deg200Ink hue in degrees; applies once saturation is above 0.
inkAppearancenumber0–1 fraction1How present the whole visual is: 1 draws it as the pattern defines it, lower fades everything including its halos. A voice assistant rests below 1 when idle and comes to full ink when it listens.
ringCountAppearanceinteger1–84Concentric range rings on the scope.
saturationAppearancenumber0–1 fraction0How far the ink moves from grey toward the hue (0 = the grey ink).
seedAppearanceinteger0–∞ (UI 0–20)0Seed for where the blips sit.
trailFillAppearanceboolean0Draw the trail as one filled gradient wedge.
trailLengthAppearancenumber0–360 (UI 10–180) deg90Length of the sweep's fading trail, in degrees.
periodMotionnumber0.05–30 (UI 0.8–8) s3.2Seconds per radar sweep.

Broadcasting

pattern: "broadcasting" · mode broadcast · speed 1× · sizes 20, 32, 64

PropCategoryTypeRangeDefaultDescription
cumulativeAppearanceboolean0Waves stay lit as they build up instead of travelling.
dotSizeAppearancenumber0.01–0.3 (UI 0.02–0.2) fraction0.07Centre dot radius as a fraction of the frame.
hueAppearancenumber0–360 deg200Ink hue in degrees; applies once saturation is above 0.
inactiveOpacityAppearancenumber0–1 (UI 0–0.5) fraction0.18Opacity of the waves that aren't lit.
inkAppearancenumber0–1 fraction1How present the whole visual is: 1 draws it as the pattern defines it, lower fades everything including its halos. A voice assistant rests below 1 when idle and comes to full ink when it listens.
saturationAppearancenumber0–1 fraction0How far the ink moves from grey toward the hue (0 = the grey ink).
sidesAppearanceinteger1–22Broadcast to one side or both.
waveCountAppearanceinteger1–8 (UI 1–4)2Waves per side.
periodMotionnumber0.05–30 (UI 0.4–4) s1.2Seconds per broadcast cycle.
reversingMotionboolean0Waves travel inward.
levelInputsnumber-1–1 (UI -0.05–1) fraction-1Signal level 0 to 1 (how many waves are lit); below 0 = animate on its own.
Advanced props (2)
PropCategoryTypeRangeDefaultDescription
strokeWidthAppearancenumber0.01–0.4 fraction0.07Wave stroke width as a fraction of the frame.
waveSweepAppearancenumber10–180 deg90Arc of each wave in degrees.

On this page