← All widgetsTier 1Time

Countdown

Countdown timer with circular gauge.

Counts down from a duration with a circular gauge and fires a `timer.complete` event when it finishes.

type · countdown
Runs entirely in the shell — no backend needed.

How to use it

Just ask for it in chat — the agent emits this widget and the shell renders it:

Try saying
a 25 minute countdown timer

Example

The agent returns this A2UI component (inside the components array of a /chat response):

countdown.json
{
  "type": "countdown",
  "duration": 1500,
  "label": "Focus",
  "autoStart": true,
  "color": "0xFF9C27B0"
}

Properties

PropTypeDescription
durationnumberSeconds to count down
labelstringCaption
colorcolorAccent color
autoStartbooleanStart immediately

Browse the full Widget Index, the Widget Catalog, or learn the A2UI system behind it.