> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperwisor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Star

> A multi-point star shape for decoration.

<Info>
  **Category:** Shapes · **Decorative:** no data binding
</Info>

## Mental model

A **Star is a rating/accent star.** Set the number of **points** for a 5-point star,
6-point, and so on.

## Settings

Common shape settings — **fill**, **stroke** (color + width), **opacity**, optional
**rotation speed** — plus the number of **points**.

## Script API example

The same interactions from a [dashboard script](/script/overview):

```js theme={null}
// Reveal a badge when a value peaks
widget.on('tempGauge', 'max', () => widget.show('warnStar'));
```

<Card title="Polygon" icon="draw-polygon" href="/dashboard/widgets/polygon">
  A regular N-sided polygon.
</Card>