KQ-264 · GUMBALL/RUN

Gumball Run

A gumball machine that actually delivers: turn the knob and a ball leaves the globe, rides the chute on an authored path, and bounces into the tray where the count ticks up. Colours cycle in fixed order, the globe visibly empties, and when it runs dry it restocks in a cascade. Three balls may be in transit before the machine asks you to wait.

KQ-264 · GUMBALL/RUN

Install

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

$ pnpm dlx shadcn@latest add @kinetiq/gumball-run

Props

capacity
number
default 12
Gumballs served before the globe restocks.
onServe
(color: string) => void
default
Fires with each served colour.