Hold Button - React Component | Kokonut UI

Hold Button

Press and hold to confirm, with a fill that drains back on early release and a drawn check on completion.

Install with

npx shadcn@latest add https://kokonutui.com/r/hold-button.json

Installation

Hold Button is a free, open-source React component in the Kokonut UI Buttons collection. Add it with the shadcn CLI, which copies the source into components/kokonutui/hold-button.tsx, so the code is yours to change.

npx shadcn@latest add @kokonutui/hold-button

Or add it by hand: install its packages, then copy the source from the code above into components/kokonutui/hold-button.tsx.

npm install class-variance-authority lucide-react motion

Usage

import HoldButton from "@/components/kokonutui/hold-button";

export default function Example() {
  return <HoldButton />;
}

Props

Prop Type Description
children ReactNode Idle label. Defaults to a verb that matches the variant.
holdDuration number Default 1200. How long (ms) the button has to be held.
holdingLabel ReactNode Default "Keep holding". Label while holding.
completeLabel ReactNode Label once the hold completes.
resetAfter number Default 1800. How long (ms) the complete state shows before resetting. 0 keeps it.
onHoldComplete () => void Called once the button has been held for the full holdDuration. A short click or an early release never calls it.

Also takes every prop of Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children"> and VariantProps<typeof holdButtonVariants>.

Dependencies

Needs Version Comes from
class-variance-authority ^0.7.1 npm, installed by the CLI
lucide-react ^0.556.0 npm, installed by the CLI
motion ^12.23.25 npm, installed by the CLI
cn from lib/utils.ts shadcn init
React 19 Your app
Tailwind CSS 4 Your app

No provider, font or global CSS to set up: the file works as soon as it lands.

Additional Buttons