Getting Started
Overview
Installation
Theme
Forms
Basic Inputs
Custom Inputs
Select
Components
Components
78
Micro Charts
Navigation
Libraries
Content Editor
Data View
Form Builder
Image Designer
Kanban Board
PDF Viewer
Video Player
Latest npm version of @ngstarter-ui/componentsWeekly npm downloads of @ngstarter-ui/components
Buy License

Gauge

Gauge is a compact circular indicator for a value from 0 to 100. Use it to show a percentage metric such as usage, quota, capacity, health, score, or completion.

Key Features:
  • Radial metric: Shows a single percentage-like value in a compact circular shape.
  • Value slot: Use ngs-gauge-value to display a number or short label.
  • Custom size: Set dimensions with Tailwind size classes or component tokens.
  • Custom stroke: Adjust strokeWidth and radius for different visual weights.

Use Gauge in dashboard cards, sidebar widgets, KPI panels, usage blocks, storage indicators, completion scores, health scores, and utilization indicators. Do not use it for loading states, linear process progress, full analytical charts, or small table-row statuses.

PropTypeDefault
value
Shows the percentage progress
number0
strokeWidth
Stroke width
number10
radius
Radius
number50