Show HN: Create diagrams of complex data flows in software systems

j0d1 | 205 points

I love it, but I can't help but wonder why I almost never see complete or up to date diagrams in an enterprise or at scale software engineering setting, despite there being so many tools in this space (mermaid, uml, draw.io, graphviz, etc). I wonder what the barrier is or how to make tools like this fundamentally different so that we would see more adoption.

This comes up frequently in the context of secure design review, or more generally when outside stakeholders need to understand a foreign system.

Nobody argues against diagrams as good practice, but so few actually make them. That tells me incentives/costs are still off, despite good intent.

Information extraction from design docs could be one approach to suggest a diagram for free but that creates a dependency on the fidelity of the design document.

beardedwizard | a month ago

This is pretty nice! Really like the choices for the Keyboard shortcuts and how they are presented.

My favorite tool for creating diagrams so far is still Drakon (try in browser: https://drakonhub.com/start-drakon).

It has the best "move element" behavior of any diagramming tool I've ever encountered (it shifts neighboring elements predictably, minimally and often in the exact way that I actually want).

gg-charts is pretty close in some respects, but still feels a bit more clunky to me, because the "move element" function gives less direct feedback, and in some cases complicates the layout more than I feel necessary.

myrmidon | a month ago

Love this. Would love to be able to: a) Pause b) Step through the individual steps (I see they're titled) c) Go back / Forward to grokk better

tristanMatthias | a month ago

Wishlist: Plug into existing tracing systems. Meaning if I use Datadog, I could use this to map my environment if I have tracing enabled.

throwaway7ahgb | a month ago

Is there a text format for this? I’d be interested in seeing if we can generate these from trace data the way that we do for sequence diagrams and flow charts.

https://appmap.io/docs/reference/navie.html#diagram

kgilpin | a month ago

Thanks for sharing your work. I too have the problems you’re attempting to address. Makes me think of LabView (which I would recommend checking out for inspiration if you’re unaware of it).

pfarrell | a month ago

This is pretty cool. I’ll definitely be following the development of this. I was just starting to look at how something similar could be done using mermaid.js or plantuml.

battered8310 | a month ago

Wow, this looks very interesting. I saw the diagram of your own application and it looks more dynamic than the ones that I am generally used to at work.

I am curious about the motivation behind this project. What experiences triggered you to think that static diagrams are a problem?

Your answer will help me decide whether I'd like to use it for my own documentation or not.

avikalp | a month ago

This is really great. However, I’d prefer this as a layer on top of an existing graphing library / syntax.

bberenberg | a month ago

Reminds me of this old project..

https://netflixtechblog.com/vizceral-open-source-acc0c32113f...

I wish ^ were still alive. It was very cool and way ahead of its time.

reacharavindh | a month ago

Wow, I'm glad that I visited HN when your tool was at the top. I'm going to use it to illustrate docs on our internal DAG-like system. By the way, is there a simple way to export the animated diagram as a GIF?

stopthe | a month ago

The site doesn't work, I've tried reaching it from Amsterdam, Netherlands. First it raises an issue with the certificate, then it's blocked by the ISP. Very strange.

Lucasoato | a month ago

In case any of you use draw.io note that you can animate lines with a right click. Last time I did this for a presentation I did have to record to gif but it worked really well.

flarg | a month ago

When going to https://gg-charts.com all I got is a popup of 1 and displayed Hacked by NSF instead.

phantomathkg | a month ago

I really liked the UI and the ease with which diagrams can be created.Will it be possible to import diagrams from other tools like draw.io here.

piyushtechsavy | a month ago

As the author of that original Redux docs tutorial and data flow graph, happy to see it being used as an example here :)

acemarke | a month ago

Very cool! Love how the links rearrange themselves when you move a node.

alabhyajindal | a month ago

My laptop screamed after I played around in the redux demo. Must be something like infinite loop.

chj | a month ago

Thanks for this! I love how minimal and intuitive it is.

Feature request - ability to export to Animated PNG!

ilt | a month ago

I'd love to see more demos

BeefySwain | a month ago

Congrats on the launch. Looks very clean.

I think the core concept is flawed, though. "Animated diagrams" are great for generating engagement on social media, but in practice an animated line doesn't tell you anything an arrow wouldn't. They just become a distraction. Plus, they make it harder to read a label on the line (and "real" diagrams should have those).

Veuxdo | a month ago

I know you said you prefer the GUI over text-based, but that was the exact thing I wanted to ask for after trying your demo. GUI just doesn’t scale like text does. How will you be able to generate a diagram from code or a running process unless you have some intermediate textual representation? I assume you do anyways, at least implicitly, to save the state of your GUI’s output. You should bring that into focus. The GUI editor is simply a nonstarter for me. How do you compare the difference between two diagrams?

IMO the editing/sharing/maintenance experience of Mermaid’s sequence diagrams is nicer. What is your opinion on sequence diagrams in general? I much prefer their static nature and directional flow over animations you have to wait for when you need to review a detail you missed, and the top/down direction is better than trying to track points moving around in arbitrary directions.

mckn1ght | a month ago

Super cool. Huge potential.

diegoholiveira | a month ago