Awesome
<div align="center"> <p align="center"> <img src="./logo.png" alt="beautiful-react-diagrams" width="750px" /> </p> </div> <br /> <div> <p align="center"> A tiny collection of lightweight React components for building diagrams with ease </p> </div> <div> <p align="center"> <a href="https://antonioru.github.io/beautiful-react-diagrams/" target="_blank"> 🌟 Live playground here 🌟 </a> </p> </div>💡 Why?
Javascript diagramming libraries are often difficult to integrate in React projects. <br /> 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 thennpm 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.
Versioning
This library follows the semver versioning standard.
Pre-release commits on the master
branch, including merge commits, lead
to automated publication to NPM under the next
tag. Pre-release version
numbers must follow the <major>.<minor>.<patch>-<tag>.<number>
, such as
5.1.0-rc.0
.
This library logo has been created using images published by the user Freepik on www.flaticon.com