Ask HN: Architecture Diagrams for GitHub Readme.md?

#1

Post by markhops » Thu, May 09, 2019, 1:22 PM UTC

Does anyone have a recommendation for a tool that can make architecture diagrams (flowcharts) like the one found here?

https://github.com/donnemartin/system-design-primer

Ideally, I would like the diagrams to be hosted somewhere, instead of attaching them to an Issue as described here:

https://stackoverflow.com/questions/14494747/add-images-to-readme-md-on-github

Also, this might be asking a lot, but it would be nice to have these images (preferably SVG) remain editable (similar to a Visio diagram) that I can put Auth in front of (since I would like to use it for my company too).

Does something like this exist?

Re: Ask HN: Architecture Diagrams for GitHub Readme.md?

#2

Post by aratno » Thu, May 09, 2019, 2:22 PM UTC

Monodraw is one option: https://monodraw.helftone.com/

Whimsical is another: https://whimsical.co/

Re: Ask HN: Architecture Diagrams for GitHub Readme.md?

#3

Post by ParameterOne » Thu, May 09, 2019, 11:37 PM UTC

https://draw.io

Re: Ask HN: Architecture Diagrams for GitHub Readme.md?

#4

Post by markhops » Fri, May 10, 2019, 12:35 PM UTC

ParameterOne wrote: post #3

https://draw.io

Not a fan of how they need your Google drive to host your diagrams.

Re: Ask HN: Architecture Diagrams for GitHub Readme.md?

#5

Post by markhops » Fri, May 10, 2019, 12:36 PM UTC

aratno wrote: post #2

Monodraw is one option: https://monodraw.helftone.com/ Whimsical is another: https://whimsical.co/

Monodraw is nice, but I wish it was web based

Whimiscal looks really cool. I really wish it would provide a shareable link to my rendered diagram (jpg or png) that I could embed in my Github readme.

Re: Ask HN: Architecture Diagrams for GitHub Readme.md?

#6

Post by ParameterOne » Sat, May 11, 2019, 1:35 PM UTC

markhops wrote: post #4

ParameterOne wrote: post #3

https://draw.io

Not a fan of how they need your Google drive to host your diagrams.

You don't need Google drive. Go to Draw.io and draw a box, then click save as. You will see a github option as well as trello/dropbox/etc. Here, ask theses guys: https://www.linkedin.com/in/gaudenzalder/ https://www.linkedin.com/in/davidbensonuk/