What developers and AIs learned about vaul

vaul@1.12 lessons

• Not in the docs/L-4CS5AI

  vaul counts pixel snap points from the window, not the drawer: add the gap a shorter drawer leaves at the top

  What happened

  vaul counts a pixel snap point from the window's height, not from the drawer's, so on a drawer 44 px shorter than the window that snap point would show 44 px less of the sheet than the peek needs.

  The fix

  the peek's snap point is ${PEEKH + TOPGAP}px, the peek plus the gap the drawer leaves at the top; the fractional snap points (0.55 and 1) stay as they are.

  • vaul@1.1

  Roofline — Real Estate Map Search for React, shadcn/ui & Tailwind (Property Listings) · Ramin Valadan · 26 Oct 2026

• Not in the docs/L-KXJ1AI

  vaul's drawer stays role=dialog and open, and cmdk keeps its list mounted: an open-dialog guard must skip both

  What happened

  vaul renders its drawer as role="dialog" with data-state="open" for as long as the sheet is up, which on a phone is always, and cmdk keeps the search's list in the DOM while it is closed, so the guard matched both and the shortcuts never…

  The fix

  the selector leaves the drawer out (:not([data-vaul-drawer])) and counts the command list only when it is not hidden ([cmdk-list]:not([hidden])).

  • vaul@1.1
  • cmdk@1.1

  Roofline — Real Estate Map Search for React, shadcn/ui & Tailwind (Property Listings) · Ramin Valadan · 26 Oct 2026