Spring physics
Critical-damped harmonic oscillator. Drag velocity carries into the settle — no jerk on flick. Sub-stepped at 240Hz, one DOM write per RAF.
A universal sheet engine. One framework-agnostic core, seven adapters, native-feel gestures.
Every layer is a real node the engine owns — nothing here is a picture of a sheet.
↓ scroll to build it
.bs-backdrop
01
Backdrop
opacity tracks progress
.bs-screen
02
Scrim
above-sheet · blur · presets
.bs-sheet
03
Surface
translate3d only · 0 reflow
.bs-handle
04
Handle
role=slider · drag zones
.bs-content
05
Content
scrollable · drag-from-content
The browser paints the sheet. This is the default.
Only the handle starts a drag — the default.
Add, remove, edit, reorder snaps. Sheet remounts live.
Cycle min↔full at decreasing intervals. Watch the FPS.
idle
Anchored elements ride the sheet edge on the compositor; scrim stages swap content per state.
Opt-in via class on .bs-root. Loads the theme CSS
lazily.
default
Critical-damped harmonic oscillator. Drag velocity carries into the settle — no jerk on flick. Sub-stepped at 240Hz, one DOM write per RAF.
Sized once via height; resized via
transform: translate3d. Zero layout per frame.
will-change gated to drag/animate.
Snap points accept px, percentages, fit,
full, plus arbitrary CSS: 50dvh,
clamp(), env().
bottom · top · left · right, plus logical
start / end that follow dir.
One engine, so a side drawer is the same sheet on another edge.
closeOnBack gives the sheet a history entry, so Back
closes it instead of leaving the page. routedTo puts it
on its own URL, and await close() waits for the history
to settle.
role=slider on handle. ↑↓ steps snaps, Home/End jumps,
Esc closes. Focus trap with restore. ARIA-live announcer. WCAG 2.1
AA.
env(safe-area-inset-*), hardware-back interception,
haptic tick on snap, body scroll lock that's iOS-safe
(position:fixed).
Use useBottomSheet() for full JSX control, or grab the
ready-made <BottomSheet>. Three layers, your
call.
Open a sheet from another sheet. Z-index, the focus trap,
inert and Escape follow the stack: only the top sheet
owns them.
Zero window at import.
useSyncExternalStore with cached snapshot. Optional
noSSR prop kills hydration mismatches in Next.js.
createSheetManager() — typed registry mapping route
keys to configs. onOpen/onClose hooks like
the original Vue 2 manager, framework-agnostic.
An opt-in second renderer paints the surface on the GPU: it bends with drag velocity and hands the text back to the DOM when it settles. Layout, scrolling and the accessibility tree never leave the DOM. Experimental: the text can shift by a few pixels when it moves into the texture.
dragFrom: handle, whole sheet, or opt-in
[data-bs-drag] islands. [data-bs-no-drag]
excludes a subtree, so carousels keep their own gesture.
Elements ride the sheet edge on the compositor via
--bs-size. Scrim stages swap content per state; docked
bars let the sheet slide under them.
/core is the engine alone at ~22 KB. Route,
persist, auto-collapse and the rest are opt-in
EngineFeatures you register per instance.
attachDebugOverlay(engine) prints live snap, size,
progress and flags from public events only — and ships zero bytes
into every other bundle.