KQ-765 · RETRY/LADDER

Retry Ladder

A retry control that keeps its history in sight. Attempts stack upward as the rungs of a ladder, each reading its number, how it differed and the error it met; when the host appends a running attempt a new rung draws across the rails on glide while the ladder grows to a measured height on glide, a failure turns the rung danger on a colour tween, and a success lands a tick on flick. The control squashes on flick when pressed, is disabled while an attempt runs, and retires once an attempt succeeds or maxAttempts is reached.

KQ-765 · RETRY/LADDER

fetch_rates0 / 4

No attempts yet.

Idle · press try

Install

One command — the source lands in your repo. Or copy it from the Code tab.

$ pnpm dlx shadcn@latest add @kinetiq/retry-ladder

Props

attempts: RetryAttempt[]; default —; The attempts so far, oldest first: id, label, status (running, failed or succeeded) and an error. The host appends a running one from onRetry.
next: string; default —; How the next attempt will differ, printed beside the control.
maxAttempts: number; default 4; Rungs the ladder allows; the control retires when reached.
onRetry: () => void; default —; Fires from the control.
retryLabel: string; default "Retry"; Copy on the control.
label: string; default —; Names the ladder for assistive technology.

Prop	Type	Default	Description
attempts	RetryAttempt[]	—	The attempts so far, oldest first: id, label, status (running, failed or succeeded) and an error. The host appends a running one from onRetry.
next	string	—	How the next attempt will differ, printed beside the control.
maxAttempts	number	4	Rungs the ladder allows; the control retires when reached.
onRetry	() => void	—	Fires from the control.
retryLabel	string	"Retry"	Copy on the control.
label	string	—	Names the ladder for assistive technology.