KQ-028 · BOTTOM/SHEET

Bottom Sheet

It snaps where your gesture was going — velocity-projected releases settle on the nearest snap point in the gesture's direction, with rubber-band overdrag.

KQ-028 · BOTTOM/SHEET
Sector map · K2

Install

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

$ pnpm dlx shadcn@latest add @kinetiq/bottom-sheet

Props

PropTypeDefaultDescription
snapPoints / initialSnap / onSnapChangenumber[] / number / (index) => void[0.4, 0.9] / 0Resting heights as viewport fractions; every settle reports its index.
open / defaultOpen / onOpenChangeboolean / boolean / (open) => voidControlled or uncontrolled visibility.
dismissible / portalbooleantrue / trueProjecting past the lowest snap dismisses; portal measures the visual viewport.
Handlecompound partThe grab pill is a real button — arrows step snaps, Home/End jump, each step announces.