Neon gauge
Preconfigured gauge to display any value reading as an arc. Allows to configure value range, gradient colors, and other settings.
Who it’s for
Anyone building a dark dashboard where the readings should glow — a wall display seen from a distance, a demo screen, an operations board designed to be read in a dim room. The measurement is standard; the point is that it stays legible and looks intentional against black.
What it does
The Neon gauge draws a reading as a glowing segmented arc. With the glow effect at 70 and a fine stripe pattern over the default 0–100 range, the fill emits a halo that makes the arc readable from across a room and animates smoothly as the value moves.
- Built to be read at distance — the glow keeps a thin arc visible where a flat one would disappear against a dark background.
- Animated movement is on by default, so a changing value is noticed rather than silently updated.
- Segmented fill gives texture to the glow instead of a flat band of light.
- The bar color can follow the value through a set of levels, so the halo itself changes color near a limit.
- Minimum and maximum are printed at the arc’s ends, keeping the scale explicit.
- Units are converted, not just appended — the gauge respects the unit set on the key and converts to the unit chosen on the widget.
- The Neon gauge shows one current reading: it is a styling preset of the same gauge engine, and the glow costs nothing but rendering.
How to set up
Data keys
The Neon gauge takes one datasource, one entity and one data key.
| Key | Role | Type | Description |
|---|---|---|---|
| Any numeric key | The value the arc fills to | Timeseries | Numeric only. An attribute works equally well. The key’s own units and decimals override the widget-level ones. |
Range
| Setting | Default | Effect |
|---|---|---|
| Min value | 0 | The arc’s empty end |
| Max value | 100 | The arc’s full end; must be greater than the minimum |
| Neon glow effect brightness | 70 | Halo intensity from 0 to 100; 0 disables the effect entirely |
| Thickness of the stripes | 1 | Segment width; 0 makes the fill solid |
How to customize
- To tune the glow — set Neon glow effect brightness between 0 and 100; lower it on bright dashboards where the halo washes the value out.
- To make the halo change color near a limit — set the Bar color levels, which the glow follows.
- To change how the value moves — set the Animation duration and easing rule, or turn animation off for an instantly updating readout.
- To change how segmented the arc looks — adjust Thickness of the stripes, or set it to
0for a solid glowing band. - To match the scale to your equipment — set Min value and Max value.
- To add a caption — turn on Units title or Label.
- To change the gauge’s shape — set Type to Arc, Donut, Horizontal bar or Vertical bar.
Tips
- Put neon gauges on a genuinely dark background and nowhere else. The glow is drawn as light spilling outward, and on a white dashboard it reads as a blurred edge rather than as an effect.
- Turn the animation off on any gauge fed by a fast-updating key. Continuous easing between values that arrive every second leaves the arc permanently in motion, which draws the eye to whichever gauge is noisiest rather than to whichever matters.
Share Your Widget with the Community
Built a custom widget? Export it as a JSON from ThingsBoard and publish it to the IoT Hub through a simple 4-step wizard (Upload, Listing, Readme, Review & Submit). Share it with thousands of ThingsBoard developers worldwide and get featured in the catalog.