NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #1327 most downloaded on npm
<img src="https://react-resizable-panels.vercel.app/og.png" alt="react-resizable-panels logo" width="400" height="210" />
Latest stable
4.24.1
Last release 4 days ago
18 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
237 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
- #492: Fix compatibility with Cloudflare workers
Fallback for type of HTMLElement to better support portal edge cases
HTMLElement to better support portal edge casesHTMLElement type to better support portal edge cases. - #484Your coding agent can read these notes before it upgrades. Set up the MCP server →
- #479: Improve support for Cloudflare Workers and Vercel Functions - #480: Fixed package.json#types reference
package.json#types reference. - #480- #478: Module is ESM-only in order to better work with modern tooling. - #475: "pointerup" and "pointercancel" listeners are now attached to the owne
Only stop propagation for pointer events with targets that are outside of a resize handle. - #467
innerHtml with insertRule to better support Trusted Types. - #473DATA_ATTRIBUTES object to simplify e2e tests. - #471Fix aria-controls attribute value for auto-generated ids. - #463
aria-controls attribute value for auto-generated ids. - #463onPointerDown, onPointerUp, and onClick callbacks to PanelResizeHandle so users can implement double-click. - #465removeEventListener call that caused pointer state to get broken between pages/routes. - #466- #427: Stacking order checks also check for SVGElements (bug fix) - #433: Exclude src directory from NPM package
Removed "engines" block and replaced with "packageManager"
"engines" block and replaced with "packageManager"document.direction for RTL detection; use inherited style insteadAdd React v19 to peer deps. - #422
Improve TypeScript HTML tag type generics
Edge case bug fix for a resize handle unmounting while being dragged
Suppress invalid layout warning for empty panel groups
Fix cursor icon behavior in nested panels
onDragging regression (#391)Add opt-in support for setting the `"nonce"` attribute for the global cursor style
"nonce" attribute for the global cursor style (#386)Improve obfuscation for React.useId references
React.useId references (#382)Force eager layout re-calculation after panel added/removed. - #375
Handle pointer event edge case with different origin iframes. - #374
Reset global cursor if an active resize handle is unmounted. - #313
Add optional minSize override param to panel expand imperative API. - #347
minSize override param to panel expand imperative API. - #347Don't trigger re-initialization logic for inline object hitAreaMargins unless inner values change. - #342
hitAreaMargins unless inner values change. - #342Prevent pointer events handled by resize handles from triggering elements behind/underneath
Replaced .toPrecision() with .toFixed() to avoid undesirable layout shift
.toPrecision() with .toFixed() to avoid undesirable layout shift (#323).toPrecision() with .toFixed() to avoid undesirable layout shift. - #323Better account for high-precision sizes with onCollapse and onExpand callbacks
onCollapse and onExpand callbacks (#325)Better account for high-precision collapsedSize values
collapsedSize values (#325)Fix potential cycle in stacking-order logic for an unmounted node
Improve resize for edge cases with collapsed panels; intermediate resize states should now fall back to the most recent valid layout rather than the i
Fix resize handle cursor hit detection when when viewport is scrolled
Fix conditional layout edge case
Fix case where pointer event listeners were sometimes added to the document unnecessarily
Pass Panel/PanelGroup/PanelResizeHandle id prop through to the DOM. - #299
Nothing published for this version
Group default layouts use toPrecision to avoid small layout shifts due to floating point precision differences between initial server rendering and cl
toPrecision to avoid small layout shifts due to floating point precision differences between initial server rendering and client hydration (#295)toPrecision for group default layouts to avoid small layout shifts due to floating point precision differences between initial server rendering and client hydration. - #295Replace useLayoutEffect usage with SSR-safe wrapper hook
useLayoutEffect usage with SSR-safe wrapper hook (#294)Resize handle hit detection considers stacking context when determining hit detection
Fixed PanelResizeHandle onDragging prop to only be called for the handle being dragged
PanelResizeHandle onDragging prop to only be called for the handle being dragged (#289)Fix resize handle onDragging callback
Fixed an issue where size might not be re-initialized correctly after a panel was hidden by the unstable_Activity (previously "Offscreen") API.
unstable_Activity (previously "Offscreen") API.Fixed a regression introduced in 2.0.0 that caused React onClick and onMouseUp handlers not to fire.
onClick and onMouseUp handlers not to fire.onClick and onMouseUp handlers not to fire. - 9e8a17bhitAreaMargins prop, which defaults to a 15 pixel margin for coarse inputs and a 5 pixel margin for fine inputs.Support resizing multiple (intersecting) panels at once (#274) This behavior can be customized using a new hitAreaMargins prop; defaults to a 15 pixel
hitAreaMargins prop; defaults to a 15 pixel margin for coarse inputs and a 5 pixel margin for fine inputs.Fixed edge case constraints check bug that could cause a collapsed panel to re-expand unnecessarily
DOM util methods scope param defaults to document
document (#262)Panel's pixel constraints will trigger revalidation of the Panel's size (#266)Update component signature to declare ReactElement return type (rather than ReactNode)
ReactElement return type (rather than ReactNode) (#256)Panel dev warning to avoid warning when defaultSize === collapsedSize for collapsible panels (#257)document (#204)Narrow tagName prop to only allow HTMLElement names (rather than the broader Element type)
tagName prop to only allow HTMLElement names (rather than the broader Element type) (#251)Export internal DOM helper methods.
Fix server rendering regression (#240); Panels will now render with their defaultSize during initial mount (if one is specified). This allows server-r
defaultSize during initial mount (if one is specified). This allows server-rendered components to store the most recent size in a cookie and use that value as the default for subsequent page visits.defaultSize during the initial mount again (e.g. so a size saved in a cookie can be used). - #240Edge case bug fix for isCollapsed panel method; previously an uninitialized collapsedSize value was not being initialized to 0, which caused isCollaps
isCollapsed panel method; previously an uninitialized collapsedSize value was not being initialized to 0, which caused isCollapsed to incorrectly report false in some cases.isCollapsed panel method returning false in some cases because an uninitialized collapsedSize wasn't treated as 0. - 097f71cRemember most recently expanded panel size in local storage
Change local storage key for persisted sizes to avoid restoring pixel-based sizes
Small bug fix to guard against saving an incorrect panel layout to local storage
Remove support for pixel-based Panel constraints; (props like defaultSizePercentage should now be defaultSize)
defaultSizePercentage should now be defaultSize)dataAttributes prop with ...rest prop that supports all HTML attributesNothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Change default (not-yet-registered) Panel flex-grow style from 0 to 1
Edge case expand/collapse invalid size guard
Better unstable Offscreen/Activity API.
Better support imperative API usage from mount effects.
onResize or onLayout more than once.Support imperative panel API usage on-mount.
Change group layout to more thoroughly distribute resize delta to support more flexible group size configurations.
Panel, PanelGroup, and PanelResizeHandle.PanelOnResize TypeScript def updated to reflect that previous size param is undefined the first time it is called.Panel, PanelGroup, and PanelResizeHandle. - #215PanelOnResize TypeScript def to reflect that the previous size param is undefined the first time it is called. - #212One column per quarter.