projectstorm /react-diagrams
a super simple, no-nonsense diagramming library written in react that just works
★ 9,438⑂ 1,177👁 144⑃ 230● 813▤ 34
+1
Daily
9,438
stars
1,177
forks
144
watchers
230
prs
813
issues
34
releases
README
Introduction ! DEMO: http://projectstorm.cloud/react-diagrams DOCS \(wip\) https://projectstorm.gitbook.io/react-diagrams Docs are currently being worked on, along with a migration path. What A flow & process orientated diagramming library inspired by Blender, Labview and Unreal engine. Modern Codebase written entirely in Typescript and React, the library makes use of powerful generics, advanced software engineering principles and is broken up into multiple modules. Hackable and extensible the entire library including its core can be extended, rewired and re-assembled into fundamentally different software to suit your own software needs. HTML nodes as a first class citizen the library was originally written to represent advanced dynamic nodes, that are difficult to represent as SVG's due to complex input requirements ux requirements. Designed for process the library is aimed for software engineers that want to rewire their programs at runtime, and that want to make their software more dynamic. Fast diagram editing the defaults provided give the highest priority to editing diagrams as fast as possible. Gallery Example implementation using custom models: \(Dylan's personal code\) !Personal Project ! Get started with the default models right out of the box: ! Installing For all the bells and whistles: text yarn add @projectstorm/react-diagrams This includes all the packages listed below \(and works \(mostly and conceptually\) like it used to in version 5.0\) A more modular approach This library now has a more modular design and you can import just the core \(contains no default factories or routing\) text yarn add @projectstorm/react-diagrams-core this is built ontop of the evolving react-canvas-core library text yarn add @projectstorm/react-canvas-core which makes use of text yarn add @projectstorm/geometry and of course, you can add some extras: text yarn add @projectstorm/react-diagrams-defaults yarn add @projectstorm/react-diagrams-routing How to use Before running any of the examples, please run pnpm build in the root. This project is a monorepo, and the packages (including the demos) require the packages to first be built. Take a look at the diagram demos or Take a look at the demo project which contains an example for ES6 as well as Typescript or Checkout the docs Run the demos After running pnpm install and pnpm build, you must then run: cd diagrams-demo-gallery && pnpm run start Building from source Simply run pnpm then pnpm build or pnpm build:prod in the root directory and it will spit out the transpiled code and typescript definitions into the dist directory as a single file. Built with react-diagrams Do you have an interesting project built with react-diagrams? PR it into this section for others to see.
Top issues
#377Crash when using smart routing27 comments · 2019-07-26#27Any plans on `group-nodes` support?24 comments · 2017-03-23#700How to limit out-ports to only have a single link, allow moving of links, and how to delete a link17 comments · 2020-08-16#678Cannot read property 'toLowerCase' of undefined CanvasWidget.tsx:6616 comments · 2020-07-18#49Add ability to select link without creating a point if the mouse is not moved15 comments · 2017-04-25#842Not working with Vite build14 comments · 2021-05-07#727Broken Rendering with Redux + Model Serialization/De-Serialization14 comments · 2020-09-19#511Integrating in an React Project14 comments · 2019-12-27
Discussions
#1052Smart & right angles routing0 comments · 2025-12-09#1046Sample project that uses react-diagram1 comments · 2025-01-07#1031How to auto-position nodes?0 comments · 2024-03-11#1026Expirimenting with zoom levels.0 comments · 2023-12-29#1015Compatibility with REMIX JS0 comments · 2023-08-15#998cannot yarn build now2 comments · 2023-05-03#984Image overlay on Nodes to change the node's appearance.0 comments · 2023-02-02
Latest release
@projectstorm/[email protected] @projectstorm/[email protected] 2024-02-15Patch Changes
- 20766f5: fix default link widget with react strict mode
- 80285fe: refactor: update lodash imports to use individual functions
- Updated dependencies [09ed60f]
- Updated dependencies [80285fe]
- @projectstorm/[email protected]
- @projectstorm/[email protected]
- @projectstorm/[email protected]