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. Switch it on in the workbench above.
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.