---
name: "@gauge-ui"
slug: "gauge-ui"
description: "Composable SVG gauge primitives for React: arcs, zones, ticks, needles and nested gauges, with spring or tween animation."
category: "Animated components"
tags: ["animation", "design-system", "hooks"]
framework: "react"
license: "MIT"
author: "thordursk"
website: "https://www.gauge-ui.dev"
github: "https://github.com/thordursk/gauge-ui"
registry: "https://www.gauge-ui.dev/r/registry.json"
pro: false
pro_url: null
github_stars: 93
component_count: 1
generated_at: "2026-10-10T06:32:55.998Z"
---

# @gauge-ui

Composable SVG gauge primitives for React: arcs, zones, ticks, needles and nested gauges, with spring or tween animation.

## Links

- Website: https://www.gauge-ui.dev
- GitHub: https://github.com/thordursk/gauge-ui
- Registry JSON: https://www.gauge-ui.dev/r/registry.json
- Directory page: https://sh4dcn.vercel.app/registry/gauge-ui
- This file: https://sh4dcn.vercel.app/md/gauge-ui.md

## Install

```sh
# add the whole registry (shadcn CLI)
npx shadcn@latest add https://www.gauge-ui.dev/r/registry.json
pnpm dlx shadcn@latest add https://www.gauge-ui.dev/r/registry.json
bunx shadcn@latest add https://www.gauge-ui.dev/r/registry.json
# clone the source repo
git clone https://github.com/thordursk/gauge-ui.git
# fetch the raw registry index
curl -s https://www.gauge-ui.dev/r/registry.json
```

## Components (1)

| name | type | description | install |
| --- | --- | --- | --- |
| gauge | registry:ui | Composable SVG gauge primitives: track, arc, zones, ticks, labels, needle, hub, dot, tooltip and value text, with optional spring or tween animation and nested… | `npx shadcn@latest add https://www.gauge-ui.dev/r/gauge.json` |

## For AI agents

```text
You are adding components from @gauge-ui to a shadcn-compatible project.
1. Read this file (https://sh4dcn.vercel.app/md/gauge-ui.md) for the component list.
2. Fetch the machine-readable index: https://www.gauge-ui.dev/r/registry.json
3. Install a single component with its install command from the table above.
4. Full structured record: https://sh4dcn.vercel.app/json (library slug: gauge-ui).
```