> ## 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.

# Ellipse

> A circle or oval shape for decoration.

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

## Mental model

An **Ellipse is a circle or oval.** A vector round shape for badges, dots, and
decoration.

## Settings

Common shape settings — **fill**, **stroke** (color + width), **opacity**, and
optional **rotation speed**. Make it a perfect circle with equal width and height.

## Script API example

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

```js theme={null}
// Pulse a dot by resizing on a timer
let big = false;
setInterval(() => {
  big = !big;
  widget.resize('pulseDot', big ? 24 : 16, big ? 24 : 16);
}, 600);
```

<Card title="All shapes" icon="shapes" href="/dashboard/widgets/shapes">
  The shared shape settings.
</Card>