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

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