Charts

Gauge

Speedometer-style semicircle gauge — displays a single value within a range with colour feedback.

Quick Preview

72%

Performance

Installation

# No extra dependencies — uses SVG

// Copy component from
src/components/charts/Gauge.tsx

Usage

import Gauge from '@/components/charts/Gauge'

const scoreSegments = [
  { value: 60, color: '#F45A5A' },
  { value: 100, color: '#D94040' },
]

<Gauge
  value={72}
  max={100}
  label="Health"
  unit="%"
  size={160}
  strokeWidth={14}
  trackColor="rgba(244, 90, 90, 0.14)"
  segments={scoreSegments}
/>

Examples

Interactive Speedometer

65km/h

Speed

System Dashboard

43%

CPU

67%

Memory

23%

Disk

89%

GPU

Threshold Segments

94%

Service Health

Size Variants

Small

Default

Large

Prompt Preview

Copy a prompt that recreates this UI

Use this prompt to ask AI for a production-ready Gauge that matches the reference styling, API surface, and interaction polish.

Copy-ready AI prompt

Starts from the current visual reference and project constraints.

Build a charts component named Gauge in React/Next.js.
Goal: recreate the same overall UI and behavior as the Gauge reference from a component gallery.
What it needs to communicate: Speedometer-style semicircle gauge — displays a single value within a range with colour feedback..

Project constraints:
- Use Next.js 16.2.6 with the App Router, React 19, TypeScript strict mode, and Tailwind CSS v4.
- Do not create a tailwind.config.js file. Use Tailwind v4 utilities and CSS variables where design tokens are needed.
- If you are implementing this inside the same project, use the Prompt font via next/font/google. If not, use the closest equivalent typeface.
- Return production-ready code with imports, responsive behavior, keyboard accessibility, and polished empty, hover, focus, active, and disabled states where relevant.
- Match the reference closely: color palette, spacing scale, border radius, shadows, icon scale, typography hierarchy, and motion timing.

Component-specific expectations:
- Use SVG or lightweight primitives unless a charting library is truly necessary.
- Keep axes, labels, legends, and thresholds visually clear and consistent.
- Avoid unnecessary dependencies unless the behavior truly requires them.
- No explicit color literals were found in the examples. Match the live reference and the project accent color when appropriate.

Props to support:
- value: number — required — Current value
- max: number — default 100 — Maximum value
- size: number — default 160 — Diameter in px
- strokeWidth: number — default 14 — Thickness of the gauge arc
- color: string — default '#F45A5A' — Base colour for the progress arc. Default colour enables semantic thresholds.
- trackColor: string — default 'rgba(15, 23, 42, 0.10)' — Track colour behind the progress arc
- label: string — Label below gauge
- unit: string — Unit suffix (e.g. "%" or " km/h")
- segments: { value: number; color: string }[] — Optional thresholds that map ranges to colours
- className: string — Additional wrapper classes

Reference usage patterns:
- No examples were documented. Infer a sensible default presentation and one richer usage example.

Feature expectations:
- Animated needle
- Semantic threshold palette
- Custom track styling
- Min/Max labels
- Custom unit

Output requirements:
- Return complete code, not pseudocode.
- Include all necessary imports and helper types.
- Keep the implementation accessible, responsive, and visually finished.
- Match the reference for color, size, shape, typography, spacing, and interaction states as closely as possible.
- If multiple files are needed, organize them cleanly and explain the file structure briefly.

Tweak only product-specific copy or data after the first generation pass.

Props

Prop	Type	Default	Description
`value`*	`number`	-	Current value
`max`	`number`	`100`	Maximum value
`size`	`number`	`160`	Diameter in px
`strokeWidth`	`number`	`14`	Thickness of the gauge arc
`color`	`string`	`'#F45A5A'`	Base colour for the progress arc. Default colour enables semantic thresholds.
`trackColor`	`string`	`'rgba(15, 23, 42, 0.10)'`	Track colour behind the progress arc
`label`	`string`	-	Label below gauge
`unit`	`string`	-	Unit suffix (e.g. "%" or " km/h")
`segments`	`{ value: number; color: string }[]`	-	Optional thresholds that map ranges to colours
`className`	`string`	-	Additional wrapper classes