Widgets

Widgets are the interactive controls and display elements on your plugin’s faceplate. BeatConnect offers 7 widget types with multiple styles each.

Control Widgets

Interactive elements users manipulate:

WidgetPurposeBest For
KnobRotary controlFrequency, gain, time, mix
SliderLinear faderVolume, pan, faders
ToggleOn/off switchBypass, enable, mode

Display Widgets

Visual elements that show information:

WidgetPurposeBest For
VisualizerAudio-reactive displayMeters, spectrum, waveform
LabelText displayPlugin name, values, status

Layout Widgets

Structural elements that organize your faceplate:

WidgetPurposeBest For
PanelBackground containerGrouping, depth, sections
SectionLabeled group frameNamed control groups

Widget Sizing

All widgets use a grid system. Standard sizes:

Knobs

SizeGrid UnitsUse
Small2×2Secondary parameters
Medium3×3Most parameters
Large4×4Primary controls
XLarge5×5Hero/main control

Sliders

OrientationGrid Units
Vertical1.5×6
Horizontal6×1.5

Toggles

StyleGrid Units
Switch2×1
Button2×2
LED1.5×1.5

Visual Hierarchy

Use size to show importance:

  • Largest = Most important parameter (hero control)
  • Medium = Standard parameters
  • Smallest = Secondary/fine-tune parameters

Color Properties

All widgets support these color properties:

PropertyPurpose
primaryColorMain accent color
secondaryColorSecondary accent
trackColorBackground/track
activeColorActive/on state
bodyColorWidget body
pointerColorIndicator/thumb
handleColorDrag handle
textColorLabel text
borderColorWidget border

Layout Tips

  1. Grid alignment - Always snap to grid for professional look
  2. Consistent spacing - Equal gaps between widgets
  3. Visual grouping - Related controls should be close together
  4. Breathing room - Don’t crowd widgets, leave margins

Choosing Widgets

Parameter TypeRecommended Widget
Continuous (frequency, gain)Knob
Volume/levelVertical slider
Pan/balanceHorizontal slider or bipolar knob
On/offToggle
Mode selection (2 options)Toggle
Mode selection (3+ options)Multiple toggles
Audio feedbackVisualizer
Value displayLabel

Style Consistency

Pick widget styles that match your plugin’s aesthetic:

AestheticRecommended Styles
Modern/Cleanminimal, flat, digital
Vintage/Retrovintage, notched
Fun/Playfularcade
Professionalstandard, led_ring

7 items under this folder.