From 3cacc0e77f565cf7b05a6e6f2ff6e4c6bf660002 Mon Sep 17 00:00:00 2001 From: Brandon Harvey <8107750+bharvey88@users.noreply.github.com> Date: Mon, 25 May 2026 19:26:55 -0500 Subject: [PATCH 1/2] [light] Add scannable effects index with CSS-animated previews --- src/content/docs/components/light/index.mdx | 300 ++++++++++++++++++++ 1 file changed, 300 insertions(+) diff --git a/src/content/docs/components/light/index.mdx b/src/content/docs/components/light/index.mdx index 3b4eab0878..d30c266ff9 100644 --- a/src/content/docs/components/light/index.mdx +++ b/src/content/docs/components/light/index.mdx @@ -498,6 +498,306 @@ light: > After setting a light effect, it is possible to reset the in-use effect back to a static light by setting the > `effect` to `none` when it is being called through Home Assistant or directly on the device. + + +### Basic animations + +These effects work on any light platform. + +
| Preview | Effect | Description | Parameters |
|---|---|---|---|
| + | Pulse | +Smooth brightness pulse | +name, transition_length, update_interval, min_brightness, max_brightness | +
| + | Random | +Random colors at fixed intervals | +name, transition_length, update_interval | +
| + | Strobe | +Cycle through a list of colors with set durations | +name, colors | +
| + | Flicker | +Candle-like brightness variation | +name, alpha, intensity | +
| + | Lambda | +Run custom C++ on each update | +name, update_interval, lambda | +
| Preview | Effect | Description | Parameters |
|---|---|---|---|
| + | Addressable Rainbow | +Hue sweeps the length of the strip | +name, speed, width | +
| + | Addressable Color Wipe | +New colors shift in at the start of the strip | +name, colors, add_led_interval, reverse | +
| + | Addressable Scan | +Single dot slides back and forth across the strip | +name, move_interval, scan_width | +
| + | Addressable Twinkle | +Random pixels brighten and fade | +name, twinkle_probability, progress_interval | +
| + | Addressable Random Twinkle | +Twinkle, but each pixel gets a random color | +name, twinkle_probability, progress_interval | +
| + | Addressable Fireworks | +Sparks burst from random pixels | +name, update_interval, spark_probability, use_random_color, fade_out_rate | +
| + | Addressable Flicker | +Per-pixel candle flicker | +name, update_interval, intensity | +
| + | Addressable Lambda | +Run custom C++ per LED | +name, update_interval, lambda | +
| Effect | Description | Parameters |
|---|---|---|
| Automation | +Run ESPHome automation actions on a loop | +name, sequence | +
| E1.31 | +Receive sACN / E1.31 frames over the network | +universe, channels | +
| Adalight | +Receive Adalight protocol over UART | +uart_id | +
| WLED | +Receive WLED UDP sync protocol | +port, blank_on_start, sync_group_mask | +
| Preview | Effect | Description | Parameters |
|---|---|---|---|
| - | Pulse | -Smooth brightness pulse | -name, transition_length, update_interval, min_brightness, max_brightness | -
| - | Random | -Random colors at fixed intervals | -name, transition_length, update_interval | -
| - | Strobe | -Cycle through a list of colors with set durations | -name, colors | -
| - | Flicker | -Candle-like brightness variation | -name, alpha, intensity | -
| - | Lambda | -Run custom C++ on each update | -name, update_interval, lambda | -
| Preview | Effect | Description | Parameters |
|---|---|---|---|
| - | Addressable Rainbow | -Hue sweeps the length of the strip | -name, speed, width | -
| - | Addressable Color Wipe | -New colors shift in at the start of the strip | -name, colors, add_led_interval, reverse | -
| - | Addressable Scan | -Single dot slides back and forth across the strip | -name, move_interval, scan_width | -
| - | Addressable Twinkle | -Random pixels brighten and fade | -name, twinkle_probability, progress_interval | -
| - | Addressable Random Twinkle | -Twinkle, but each pixel gets a random color | -name, twinkle_probability, progress_interval | -
| - | Addressable Fireworks | -Sparks burst from random pixels | -name, update_interval, spark_probability, use_random_color, fade_out_rate | -
| - | Addressable Flicker | -Per-pixel candle flicker | -name, update_interval, intensity | -
| - | Addressable Lambda | -Run custom C++ per LED | -name, update_interval, lambda | -
| Effect | Description | Parameters |
|---|---|---|
| Automation | -Run ESPHome automation actions on a loop | -name, sequence | -
| E1.31 | -Receive sACN / E1.31 frames over the network | -universe, channels | -
| Adalight | -Receive Adalight protocol over UART | -uart_id | -
| WLED | -Receive WLED UDP sync protocol | -port, blank_on_start, sync_group_mask | -