# Needle gauge (Gauge example)

> WestCoast Charts 1.1.5, release, public Core release, on npm. HTML: https://westcoast-charts.com/gallery/gauge/needle-gauge/ · Index for agents: https://westcoast-charts.com/llms.txt

Pointer with bands as track.

- Chart type: `gauge` (Gauge)
- Collection: Gauge · Gauge
- Raw configuration: https://westcoast-charts.com/gallery-src/gauge/needle-gauge.js
- Standalone example: https://westcoast-charts.com/embed/samples/wcc/gallery/gauge/needle-gauge.html

## Setup

```js
import WestCoastCharts from 'west-coast-charts'
import types from 'west-coast-charts/types'

WestCoastCharts.use(types)
```

## Options

```js
const options = {
  chart: {
    height: 340,
    fontFamily: "Inter, Geist, \"IBM Plex Sans\", system-ui, sans-serif",
    type: "gauge",
    toolbar: {
      show: false
    }
  },
  series: [64],
  labels: ["CPU"],
  plotOptions: {
    radialBar: {
      shape: "needle",
      startAngle: -135,
      endAngle: 135,
      bands: [
        {
          from: 0,
          to: 60,
          color: "#16a34a"
        },
        {
          from: 60,
          to: 85,
          color: "#f59e0b"
        },
        {
          from: 85,
          to: 100,
          color: "#dc2626"
        }
      ],
      bandsStyle: {
        gap: 3,
        strokeWidth: "100%",
        hideTrackWhenPresent: true
      },
      ticks: {
        show: true,
        major: {
          count: 6
        },
        minor: {
          count: 4
        }
      }
    }
  },
  theme: {
    mode: "light",
    preset: "coastal"
  }
}

const chart = new WestCoastCharts(document.querySelector('#chart'), options)
await chart.render()
```

## Verify

- Text check (Library 1.1.5): load `west-coast-charts/agent/describe` and call `chart.describe({ format: "json" })` for the actual drawn state. The live reader is on this example’s HTML page.
- Command line (Public agent tools 0.2.3, tested with Library 1.1.5; available from the versioned GitHub release and npm, https://westcoast-charts.com/docs/cli/index.md): `wcc chart export gauge-needle-gauge.json --out gauge-needle-gauge.svg --with-table` (save the options above as JSON first)