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

PropTypeDefaultDescription
capacitynumber12Gumballs served before the globe restocks.
onServe(color: string) => voidFires with each served colour.