Show a key data point in an intuitive gauge format, with contextual bands for categorization.

Usage no npm install needed!

<script type="module">
  import nativescriptUiGauge from '';


NativeScript UI Gauge


The NativeScript UI Gauge plugin allows you to display the current status of a value within a range of upper and lower bounds, illustrate progress towards a goal, or a summary of a fluctuating metric. Some features include:

  • Add one or more RadialScale instances to your gauge;
  • Use Bar indicators to visualize a range of values or a Needle indicator to point to a specific value;
  • Include ready-to-use animations for smooth transition effects.


In Command prompt / Terminal navigate to your application root folder and run:

tns plugin add nativescript-ui-gauge


To use the gauge plugin, you need to add an instance of RadRadialGauge. It has a scales collection, which allows you to add a number of instances of type RadialScale. Each scale has an indicators collection that allows you to add different indicators. The indicator can be either of type RadialBarIndicator or RadialNeedle. More information is available in the Guides for:

API Reference

Here is the API Reference section.

Sample Apps

The features of the plugin are demonstrated in the Sample apps for:

Release Notes

The release notes are available here.

Get Help

Please, use github issues strictly for reporting bugs or requesting features.