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

snapPoints / initialSnap / onSnapChange
number[] / number / (index) => void
default [0.4, 0.9] / 0
Resting heights as viewport fractions; every settle reports its index.
open / defaultOpen / onOpenChange
boolean / boolean / (open) => void
default
Controlled or uncontrolled visibility.
dismissible / portal
boolean
default true / true
Projecting past the lowest snap dismisses; portal measures the visual viewport.
Handle
compound part
default
The grab pill is a real button — arrows step snaps, Home/End jump, each step announces.