![GitHub stars](https://img.shields.io/github/stars/antonioru/beautiful-react-diagrams?style=social)
A tiny collection of lightweight React components for building diagrams with ease
![Diagrams banner](https://github.com/hoangdaicntt/beautiful-react-diagrams/raw/HEAD/./beautiful-react-diagrams.png)
💡 Why?
Javascript diagramming libraries are often difficult to integrate in React projects.
Different patterns not always fit the React nature and having a component's state in in sync with an external
diagramming library might be quite difficult especially when the latter had been built in a different paradigm (such as MVC, for example).
For this reason we created beautiful-react-diagrams
an easy-to-customise functional diagramming library to build
diagrams with ease.
🎓 Principles
- Lightweights: import nothing but a single lightweight javascript.
- Controlled components: exports controlled components only.
- Renderers: the involved components can be easily replaced with your own by using the
renderer
props. - Easy to style: built using CSS vars only.
☕️ Features
- Concise API
- Small and lightweight
- Easy to use
- Easy to customise
Contributing
Contributions are very welcome and wanted.
To submit your custom pull request, please make sure your read our CONTRIBUTING guidelines.
Before submitting a new pull request, please make sure:
- You have updated the package.json version and reported your changes into the CHANGELOG file
- make sure you run
npm run lint
, npm build
and then npm test
before submitting your merge request. - make sure you've added the documentation of your changes.
- if you've changed the signature of a component, please make sure you've updated the
index.d.ts
file.
Credits
This library is provided and sponsored by:
As part of our commitment to support and contribute to the open source community.
Icon made by Freepik from www.flaticon.com