Skip to content

GaugePro

A value against a known range as a ring that fills once, springs to new values while the percent rolls, and changes tone and caption exactly at its thresholds.

oxyn add gauge
72%Busy8 cores
43 GBMemory
The code is part of Oxyn Pro

The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.

Get Pro

Rendered from Rust at build time · goes live when visible

When to use

  • A value against a known range as a 270° ring.
  • The ring fills once on mount without overshoot, then springs to new values while the number rolls digit by digit.
  • Threshold bands (Band { from, tone, label }) set the tone and caption: the highest band reached wins, exactly as the value crosses it.
  • Without bands the tone applies. raw shows the value with a unit instead of the percent of the range; detail adds a second caption.

When not to use

  • A launch countdown with digits that roll per unit, a compact one-line variant, hours absorbing days when days are hidden, and a live state with a pulsing dot at zero: use Countdown instead.
  • A total that moves clearly: use Animated counter instead.
  • A collapsible JSON tree with search, paging for long arrays, copy value or path, the current path under the tree and full keyboard moves: use JSON viewer instead.

Installation

Gauge is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.

Terminal
oxyn add gauge

Usage

Dioxus · rust
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Examples

Bands

Bands set the tone and caption as the value crosses them.

72%Busy8 cores
43 GBMemory
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Critical

Past the danger band.

94%Critical8 cores
56 GBMemory
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

Plain

No bands: one tone.

38%CPU8 cores
Code Pro
The code is part of Oxyn Pro

The preview is free. Pro opens the code of every Pro component, screen and template.

Get Pro

API reference

Gauge

PropTypeDefaultDescription
valuerequiredf64—Value.
minf64Default::default()Lower bound.
maxf64100.0Upper bound.
labelStringDefault::default()Label under the number.
detailOption<String>Default::default()Second caption line.
toneString"accent"Tone when no band applies.
bandsVec<Band>Default::default()Threshold bands.
sizef32140.0Diameter in px.
rawboolDefault::default()Show the raw value instead of the percent of the range.
unitStringDefault::default()Unit after a raw value.

Read from the Rust signature and doc comments.

Accessibility

  • role=meter with min, max, now and a valuetext that includes the band.
  • Reduced motion lands on the value at once.
From the spec
  • role=meter with min, max, now and a valuetext including the band.

Motion & interaction

Timing
  • First fill 1 s ease-out; changes 700 ms spring; digits roll 260 ms.
  • Reduced motion lands on the value at once.

Responsive behaviour

  • The size prop sets the diameter.
Edge cases (spec)
  • size sets the diameter (140).

Notes for AI

  • Import Gauge from oxyn_dioxus and include STATUS_INDICATOR_CSS plus the token stylesheet once.
  • A GPUI version exists: GaugeEl in oxyn_gpui.
  • Props to set first: value.
  • Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.

Guides

Oxyn · 74 free components · 264 Pro components · 96 screens · 20 blocks · Dioxus and GPUI