[](https://vueflow.dev/)    and let viewport emit pane ctx menu.
Full Changelog: v1.48.0...v1.48.1
-
- 1.48.021 Nov 2025
Release notes
Open source →What's Changed
Minor Changes
- #1978
7acd6d7Thanks @bcakmakoglu! - Separate flow import and export object shapes and interfaces. An export object has all fields as required, while an import object makes all fields optional.
Patch Changes
-
#1988
dd6a91fThanks @bcakmakoglu! - Correctly unwrap disableKeyboardA11y ref when checking if a selection can be moved or not. -
#1989
3f6e09aThanks @bcakmakoglu! - Use position instead of computedPosition as updated position when moving a child node via keyboard.
Full Changelog: v1.47.0...v1.48.0
Additional notes
Open source →Bug Fixes
- Unwrap disableKeyboardA11y to check if keyboard movement is allowed (#1988) (ce4a8fb)
- Use position instead of computedPos as keyboard move pos (#1989) (0ced769)
Miscellaneous Tasks
Refactor
- Separate import and export objects and interfaces (#1978) (6008d63)
- #1978
- 1.47.02 Oct 2025
Release notes
Open source →What's Changed
Minor Changes
- #1967
7828f4aThanks @bcakmakoglu! - Replace the existingoffsetoption for fitView with a more expressivepaddingoption allowing users to define padding per sides.
Full Changelog: v1.46.5...v1.47.0
Additional notes
Open source → - #1967
- 1.46.522 Sept 2025
Release notes
Open source → - 1.46.411 Sept 2025
Release notes
Open source → - 1.46.35 Sept 2025
Release notes
Open source → - 1.46.231 Aug 2025
Release notes
Open source → - 1.46.131 Aug 2025
Release notes
Open source →Bug Fixes
- Use valid handle result as connecting handle (#1932) (dd48e47)
- Correctly check if an event has any listeners bound to it (#1935) (e9f0cdf)
- Skip resize handler if node not visible (#1936) (c9c26d0)
- Prevent multi touch from aborting connections (#1938) (490473d)
Documentation
- Remove info on pointer events removal when elements selectable is false (3c96b38)
Refactor
- Avoid passing reactive values to position changes (#1937) (bd606b9)
- 1.46.015 Aug 2025
Release notes
Open source →Bug Fixes
- Use 1 as zoomstep for minimap and apply factor based on macOs (#1923) (58a52e1)
- Fetch correct source and target nodes for isValidConnection (#1922) (c2aad1e)
Documentation
- Helper lines (#1915) (5dc276a)
Features
- Expose wheelDelta utility (#1918) (5fbbc82)
Refactor
- Use event target for Handle pointer down events (#1924) (299a045)
- 1.45.17 Aug 2025
Release notes
Open source →Bug Fixes
- Use correct handlesuffix in getHandleConnections (#1880) (a43da6f)
- Add
type="button"to avoid form submissions (#1911) (#1912) (dfae661) - Emit node drag-start, drag and drag-end events on selection drag (#1913) (ed18865)
- Calculate overlapping area correctly (#1914) (e97a65b)
Documentation
- Code errors in "Updating Node Data" (#1900) (b5c4c0e)
Examples
- Cleanup basic example (e094426)
Refactor
- Add auto-scale prop & scale resize controls with zoom level (#1872) (f4e139f)
- 1.45.010 Jun 2025
- 1.44.019 May 2025
- 1.43.215 May 2025
- 1.43.124 Apr 2025
Release notes
Open source →Bug Fixes
- Add missing vue-flow__container class to marker defs (#1833) (ae9c6a0)
Ci
- Use turbo remote cache (00e2146)
- 1.43.023 Apr 2025
Release notes
Open source →Bug Fixes
- Add aria hidden to markers (#1817) (cb588c8)
- Subtract container bounds when getting pointer position (#1829) (265f928)
- Fall back to changedTouches for touchend events (#1830) (cc65f12)
Documentation
- Correct template syntax (#1797) (8f5f573)
Miscellaneous Tasks
- Cleanup getHandleBounds (#1828) (7d9ffe3)
Refactor
- Allow passing null/undefined to use node connection args (#1820) (7a09afa)
- 1.42.529 Mar 2025
- 1.42.417 Mar 2025
- 1.42.313 Mar 2025
Release notes
Open source → - 1.42.29 Mar 2025
Release notes
Open source →Bug Fixes
- Bind attrs to minimap node (#1754) (acdd1ad)
- Prevent pane click event when connection is in progress (#1776) (49b2780)
- Avoid removing handle bounds on handle unmount (#1781) (dd9c92f)
- Set default value for isVisible to undefined (#1785) (2ba98ef)
Miscellaneous Tasks
- Cleanup (67b652e)
- 1.42.116 Jan 2025
Release notes
Open source →Bug Fixes
- Correct connection keys (#1749) (424f6cf)
Miscellaneous Tasks
- Simplify animated layout example (#1747) (e94611a)
- 1.42.012 Jan 2025
Release notes
Open source →Bug Fixes
- Hide minimap node if graph node is hidden (#1739) (0a0d8af)
Features
- Add
useNodeConnectionscomposable (#1728) (268ed0e)
Miscellaneous Tasks
- Update license (dbd9330)
- Add new sandbox links to docs (46f3892)
- Update issue template (b9c9cd9)
- Open links in new tab (a8f7e36)
- Cleanup card styles (1c5caff)
Refactor
- 1.41.74 Jan 2025
Release notes
Open source →Bug Fixes
- Add missing import (f438acb)
- Use center position of handle as snapping point for connection lines (#1625) (b33da47)
Documentation
Miscellaneous Tasks
- Add (041fd87)
- 1.41.67 Dec 2024
Release notes
Open source →Bug Fixes
- Prevent scrolling when using arrow keys to move nodes (#1698) (04d1355)
- Prevent scrolling when using arrow keys to move node selection (#1702) (600d1a6)
- Update source/target node of updated edge (#1705) (7a022c8)
- Allow control key as pan activation key code (#1707) (f4f2494)
Documentation
- Add loopback edge example (#1708) (4d09783)
- 1.41.513 Nov 2024
Release notes
Open source →Bug Fixes
- Check if dragEnd event is UseDrag or MouseTouch event (#1680) (5a028cf)
- Set default offset to
0(#1692) (129d543) - Allow using + as a key in key combinations (#1693) (2e2fa9a)
- Release key combination presses (#1696) (4b8139d)
- Escape node labels (#1695) (f7a2664)
Documentation
- 1.41.41 Nov 2024
Release notes
Open source →Bug Fixes
- If selection key code is true prevent pan on drag on left mouse btn (#1670) (1e3acb1)
- 1.41.31 Nov 2024
Release notes
Open source →Bug Fixes
- Typo in SnappableConnectionLine.vue (#1638) (a90010b)
- Allow pan on drag for non left-btn when selectionKeyCode is
true(#1662) (fe552fc) - Use all handle bounds in loose connection mode (#1665) (cfc2332)
- Start patterns at 0,0 (#1666) (900850d)
- Set
isPressedtotrueonblurandcontextmenuevents if permant keypress is enabled (#1667) (72e0e2e) - Allow pan on drag for other mouse btns if left is disabled (ecd21ce)
Miscellaneous Tasks
- Update deps (#1633) (de6f042)
- 1.41.216 Sept 2024
- 1.41.16 Sept 2024
- 1.41.030 Aug 2024
Release notes
Open source →Bug Fixes
- Don't set user selection flags on pointer down (#1600) (eb12bdc)
Documentation
Features
- Add getHandleConnections action (#1595) (9c003d4)
Miscellaneous Tasks
- 1.40.120 Aug 2024
- 1.40.019 Aug 2024
Release notes
Open source →Bug Fixes
- Correct controlled flow docs and replace
applyChangeswithapplyDefault(#1574) (876c198) - Simplify event emit definitions to avoid hitting complexity limit of TS (#1585) (ebc604d)
- Only display grab cursor when panOnDrag is on left mouse button (#1586) (e90f4cc)
Documentation
- Update layouting example (#1576) (2976b11)
Refactor
- Remove null as return type of data in
useNodesData(#1575) (1d772af)
- Correct controlled flow docs and replace
- 1.39.36 Aug 2024
Release notes
Open source → - 1.39.25 Aug 2024
Release notes
Open source → - 1.39.127 Jul 2024
Release notes
Open source →Bug Fixes
- Check if injected state matches options and scope id (#1562) (fff558f)
Miscellaneous Tasks
- Enable sitemaps (#1554) (6d9535a)
- 1.39.015 Jul 2024
Release notes
Open source →Bug Fixes
- Dispatch click if drag move was attempted (#1534) (8539731)
- Handle pointer capture for selection on drag (#1543) (f329831)
- Prevent calling selectionEnd on selection click (#1545) (763f107)
Features
- 1.38.59 Jul 2024
Release notes
Open source →Bug Fixes
- Ignore minor drag movements when marking aborted drag (dab5ab4)
Miscellaneous Tasks
- Add (f63e0ef)
- 1.38.48 Jul 2024
Release notes
Open source →Bug Fixes
- Emit node click if drag was aborted (#1525) (9d14595)
Miscellaneous Tasks
- Cleanup deprecation notices (#1527) (0a0dfe9)
- 1.38.38 Jul 2024
- 1.38.21 Jul 2024
- 1.38.11 Jul 2024
Release notes
Open source → - 1.38.01 Jul 2024
Release notes
Open source →Bug Fixes
- Remove v-memo from edge renderer (#1506) (a52ac6e)
- Correct pane pointer evt handlers (#1505) (e57f22c)
Documentation
- Add section on changes (3ca9aca)
- Add info on handle limit (ea59a71)
- Add info on connection mode (182a6d9)
Features
- Make
useKeyPresspublic and export it (e435485) - Allow string array or object as class to node/edge objects (#1502) (410765b)
Miscellaneous Tasks
- Cleanup (e94e0e8)
- Add info on v-model (04524d2)
- Add (e1e5282)
- Cleanup handle utils (#1497) (8454dca)
- Cleanup pane (#1507) (266f874)
Refactor
- Replace
untilwatcher withonMountedin handle cmp (#1488) (cf32d59) - Allow passing target to
useKeyPress(ea75f8a) - Use pointer evts in pane and prevent cancel of selection (4effbb0)
- Calculate correct handle pos in handle lookup (#1494) (09e2221)
- Remove useWindow (#1504) (545bb4e)
- Use correct end handle position in connection line (#1508) (3489fae)
- 1.37.118 Jun 2024
- 1.37.018 Jun 2024
Release notes
Open source →Documentation
- Add handles section to guide (c30222e)
- Update handle docs (532d522)
- Update edge utils docs (070d78d)
- Update prerequisites (96ec3e7)
- Update getting-started page (1bacc92)
- Update theming page (d51203c)
- Update nodes / edges pages (76fe779)
- Update controlled flow page (c7049e3)
- Update config page (20d18ee)
- Update state page (7f2917a)
- Update troubleshooting page (865fe72)
Features
- Add EdgePathParams type to edge utils (#1479) (9b4e3b2)
Miscellaneous Tasks
- Add state injection section to
useVueFlowdocs (fe55415) - Update README (202d767)
- Fix typo and update title (ff05551)
- Cleanup v-model usages (889797e)
- Update validation example (55a76cd)
Refactor
- 1.36.012 Jun 2024
Release notes
Open source →Bug Fixes
- Add width/height to icons (6ee3170)
- Hide graph until initial fitview is done (#1459) (ed2e574)
- Event type (19df6ca)
Documentation
- Prettify example css files (51986d7)
Examples
- Update pinia example (#1458) (6503b3e)
- Add screenshot example (#1456) (f74be96)
- Add math example (#1461) (a8ba973)
- Add confirm delete example (#1466) (257c7aa)
Features
Miscellaneous Tasks
- Cleanup math example (67da354)
- Correct header styles (ba43421)
- Update repl vue version (50a3b0e)
- Update save and restore example (5e953bd)
- Update math examples styles (ee8d30d)
- Update interaction example styles (01e1b32)
- Update visibility example styles (78f2635)
- Update vitepress to latest (#1468) (5dc8711)
- Update example styles (#1469) (d71de0a)
- Update deps-dev (#1473) (a647472)
- Cleanup unused event arg (#1475) (850f54a)
Refactor
- Reduce node bounds calculation (#1453) (cd5103e)
- Use for loop (9a7e4ac)
- Remove initialized from graph-nodes (#1457) (0c5dfdd)
- Remove node intersections arg from drag events (#1460) (0825101)
- Remove connectedEdges from node mouse events (#1464) (798faf1)
- Deprecate
useVueFlowoptions arg (#1465) (70b39cc) - Replace arr reduce methods (#1467) (d658c1d)
- Cleanup connection line component (#1470) (d429394)
- 1.35.06 Jun 2024
Release notes
Open source →Bug Fixes
- Disable zoom on mobile when zoomToPinch is false (#1449) (1b5e14a)
- Disable drag when using multi-touch (#1448) (8bc1c99)
- Use computed edge ref (faf67c2)
Documentation
- Cleanup examples (a220161)
Features
- Add edge id to handle connections (1bb7a19)
Miscellaneous Tasks
- Add (0d971d8)
- Add todos for parentId (5703647)
- Add (688f886)
- Update (329be6b)
- Add (e5508bc)
- Add (0c1bd1b)
- Cleanup (25bb585)
- Add missing container class name (40f2421)
Refactor
- Use
vue-flow__markeron marker defs el (5d3f87f) - Remove auto-generated handle ids (c822f9c)
- Check if starting handle exists (660831c)
- Use all nodes in node renderer (ea45545)
- Render null if node is hidden (3498399)
- Render null if edge is hidden (5e9db1c)
- Remove hidden check from
getNodes&getEdges(cc0b8b6) - Use node/edge id as only dependency for nodes/edges list (#1447) (876b71d)
- Use node lookup map internally (#1450) (a592fbd)
Testing
- Update handle ids in tests (82d9991)
- 1.34.131 May 2024
- 1.34.028 May 2024
- 1.33.815 May 2024
- 1.33.712 May 2024
Release notes
Open source →Bug Fixes
- Allow wheel to bubble if not used by vf (7f51fae)
Miscellaneous Tasks
- Cleanup reactivity transform (8d3887f)
- Replace
dagrewithdagrejs/dagre(f1bd5b5) - Update pnpm version to 9 (1206308)
- Update pnpm version to 9 (cefd802)
- Update turbo to latest (f059ba2)
- Update node to 20 (880fc15)
- Update package manager field (6e64229)
- Correct dagre import path (adfc01d)
- Add (afdf1a4)
- 1.33.629 Apr 2024
Release notes
Open source →Bug Fixes
- Set ltr for vue flow wrapper (590afc8)
- Allow pinch-zoom if preventScrolling is disabled (ffb649e)
- Pass path options to edges (464dc58)
- Add options to useKeyPress (b0f1bf0)
- Prevent delete action if inside input field (84969ab)
Documentation
- Replace
source.idwithsource(#1369) (11229e4)
Miscellaneous Tasks
- 1.33.524 Mar 2024
- 1.33.46 Mar 2024
- 1.33.36 Mar 2024
- 1.33.228 Feb 2024
Release notes
Open source →Bug Fixes
- Remove
refprop fromBaseEdge(ba90a48) - Use nullish check to fallback to default center (a8c09a9)
- Check if dimensions exist in
useNodesInitialized(3ed91a0)
Miscellaneous Tasks
- Remove
- 1.33.123 Feb 2024
- 1.33.021 Feb 2024
Release notes
Open source →Bug Fixes
- Correct prop names for node guide (#1321) (e64ab35)
- Prevent esc keypress when a11y is disabled (f815ef6)
- Use default cursor and apply drag cursor if node is draggable (c48d3c9)
Features
- Add type and id to
useNodesData(68ba907)
Miscellaneous Tasks
- Cleanup pkg json fields (978d180)
- Update README.md (c24287d)
- Add (5336209)
- Add (bb8fc95)
- Cleanup (c7313ca)
- Cleanup (df591b1)
- Add (54b3f22)
Refactor
- Replace vueuse imports with vue (e5a8465)
Testing
- Update
useNodesDatatests (4666fec)
- 1.32.115 Feb 2024
Release notes
Open source → - 1.32.015 Feb 2024
Release notes
Open source →Bug Fixes
Documentation
Examples
Features
- Add animation edge to layouting example (75355b0)
- Wait for edge animation to finish to load node (fafad1e)
- Add shuffle to layout example (a0abe3a)
- Add
useLayoutcomposable (ce7333f) - Add
useNodesInitializedcomposable (f2165af) - Add
edgeIdtouseHandleConnectionsreturn (3a0dc0f)
Miscellaneous Tasks
- Update validation example text (30f158c)
- Cleanup styles (abf5c3d)
- Set LR as default in layouting example (2910951)
- Update layout example styles (f9e4d84)
- Reorder menu items (a99c620)
- Cleanup layouting example (dc8faec)
- Colors edges based on target node (c9f8f6f)
- Put all actions into single panel (caf874d)
- Cancel upcoming tasks if stopped (51c0ee0)
- Abort animation if task was cancelled (4fc7342)
- Cleanup comments (8226796)
- Cleanup styles (c65f5cf)
- Add spinner to stop btn (0c441b3)
- Cleanup edges example (f67e5a5)
- Update license (060f9e4)
- Add (eb78f77)
- Cleanup tsconfig & vite config (49a9f4a)
- Add missing generic for output node (ee8748e)
- Update composable jsdocs (fbb3f63)
- Remove experimental from state (bbf16e3)
- Cleanup (0139e6e)
- Add (bc0a33d)
- Add (55f0110)
- Add (31903e4)
- Deprecate flow props (46be1fe)
Refactor
- Use composable tester cmp (9837e0d)
- Use connection line tester cmp (96b93e3)
- Use
dataobj for labels in default nodes (6c638b8) - Deprecate bgcolor prop (d288a9b)
- Deprecate getters (c8c77a2)
- Use
useNodesInitializedto emitnodesInitialized(ffdea45) - Rename
useViewporttouseViewportHelper(300c742) - Use all nodes for handle lookup (dda5b58)
Testing
- Add
useNodesInitializedtest (3fa7fde)
- 1.31.05 Feb 2024
Release notes
Open source →Bug Fixes
- Import pinia example (1c54e39)
- Set opacity on intro until el are set (da8f82a)
- Update node dimensions on next tick (4bbc14b)
- Use existing node/edge obj for assignment (983971f)
- Avoid options passed to
useVueFlowoverwriting default state (04658b2) - Avoid adding invalid edges (like null or undefined) (aaf1069)
Documentation
- Update basic example (4b4bcdc)
- Add troubleshooting page (0bfb5f4)
- Add dagre layout example (3220e20)
Features
- Add
useNodeIdcomposable (00a1f9d) - Add
useHandleConnectionscomposable (064cfd8) - Add
inithook (fd84025) - Add viewport helper to state (c855dfe)
- Add
updateNode&updateNodeDataactions to store (fe1d801) - Add
useNodesDatacomposable (cecf9d4) - Add error args to err (f36fa77)
Miscellaneous Tasks
- Update vueflow config docs (ab568b1)
- Add (1ed6dbe)
- Cleanup (a9bd82d)
- Add (3f5519d)
- Cleanup (0941e60)
- Add (7672672)
- Add (662c5fd)
- Add (3e9840a)
- Deprecate event properties of nodes and edges (8db9b1a)
- Add (66d7198)
- Add (9e72e72)
- Cleanup vueflow cmp (557a679)
- Add (fbadf94)
- Add (0e03b16)
- Cleanup (eca0447)
- Add (c443af6)
- Add (1dff3a1)
- Cleanup
useNodesDatatypes (533e37e) - Add (6e162d5)
- Update jsdocs (2ca5bd8)
- Add docs about new composables (c381e6c)
- Update custom node example (fc2f36b)
- Add cdn example file (1006006)
- Update custom node example (2637733)
- Cleanup basic example and expand comments (3c8182e)
- Cleanup connection line example (27f54fd)
- Cleanup connection radius example (be57e51)
- Update drag and drop example (88beaec)
- Update edges example (14f3abe)
- Remove
emptyexample (f5b3d83) - Update hidden example (8ce3e03)
- Remove horizontal example (02057b6)
- Update interaction example (11f92f4)
- Update intersection example (d732597)
- Update multi example (0348850)
- Cleanup examples (24c2091)
- Cleanup EdgeWrapper (cedb1f5)
- Update (cc20329)
- Add (3c288e6)
- Add (83848f4)
- Deprecate some node props (daff22f)
- Correct link (05c4677)
Performance
- Replace Array.forEach loops (c4b4a04)
Refactor
- Replace watchEffect with onMounted/onBeforeUnmount (d001d80)
- Remove error from
useNodeId(aab31f8) - Find handle by id regardless of num of handles (84c2f6d)
- Remove unnecessary keys (97f4a17)
- Move fitViewOnInit to node dimensions update (f09b7d9)
- Omit events when calling
toObject(72cc175) - Use
useOnInitHandlerto emitpaneReadyevent (5798cc5) - Allow passing
MaybeRefOrGettertouseNodesData(f4fb4d8) - Allow
nullinstead ofundefinedas id foruseHandleConnections(7161e9e) - Add missing viewport helper functions to actions (417a301)
- Call nodes initialized whenever
areNodesInitializedis true (584782b) - Show repl import map and tsconfig opts (6f33a3b)
- Use wider styles for example pages (32700b1)
- Call
fitViewOnInitwhen node dimensions are initially set (0544fbd) - Pass renderers to viewport cmp as slots (cc9f4fb)
- Cast zIndex to ref (259514a)
- Remove exports from barrel files (308338f)
Testing