Docs
Widgets / directory

Scene

SCENE

High-level trigger surface that fires a preconfigured scene instead of a single pin write.

At a glance

Default4 x 2
Minimum2 x 1
Resizeboth
Pinoptional
Interactiveyes

Behavior

  • Great for grouped actions like shutdown, startup, brew cycle and night mode.
  • Lets the dashboard stay concise even when many writes must happen together.
  • In the app each scene stores an ordered list of ScenePinAction entries with deviceId, pinType, pin, value and label.

Firmware contract

The widget itself does not need a pin; the scene resolves into server-side actions.

On the app side this widget snaps to the 8-column square grid and uses both resizing. Its raw type is SCENE and the matching icon token in the app is bolt.fill.

Pin support: No direct pin required on the widget itself; scene steps can target many pins and devices.

Transmission: Invokes a higher-level scene action rather than sending one raw pin payload.

Canvas preview

docs.widget.preview
Scene
stable
STATUS

Widget contract

PropertyValue
Raw typeSCENE
Default size4 x 2
Minimum size2 x 1
Resize modeboth
Pin requirementoptional / infrastructure
Pin supportNo direct pin required on the widget itself; scene steps can target many pins and devices.
Interactiveyes
TransmissionInvokes a higher-level scene action rather than sending one raw pin payload.

Allowed pin families

No direct pin required on the widget itself; scene steps can target many pins and devices.

Transport path

Invokes a higher-level scene action rather than sending one raw pin payload.

Operational limits

Needs backend/server support for the actual scene graph

Configuration surface

  • scene label and visual identity matter more than geometry
  • each action includes deviceId, pinType, pin, value and optional label
  • best combined with published project templates or automation presets

Limits and caveats

  • Needs backend/server support for the actual scene graph
  • Permissions should follow project sharing and marketplace rights
  • The widget itself is only the trigger surface; the board ultimately receives the resulting pin writes one by one

Layout notes

Canvas footprint

4 x 2

Default footprint in the Plynx canvas before user resizing.

Resize floor

2 x 1

The minimum size accepted by the app during drag-resize.

Interaction model

Live input

Whether the user edits state directly or only reads it.

Related widgets

Button

Momentary or toggle actuator for a single virtual or hardware pin.

Styled Button

A richer button with distinct on/off labels and color states.

Slider

Horizontal continuous input with min, max and send strategy options.

Vertical Slider

Vertical range control for compact side panels and console-style layouts.