Most active commenters
  • x0z(17)
  • (3)
  • esseph(3)
  • mh-(3)

374 points x0z | 86 comments | | HN request time: 1.814s | source | bottom
1. x0z ◴[] No.44431179[source]
I've not done anything special here, just wrapped the community edition of ISOFLOW https://github.com/markmanx/isoflow and made it dead easy to set up and run. You can now export and load JSON backups of your diagrams allowing you to essentially have as many as you want, which the community version of ISOFLOW restricts. Enjoy!
replies(2): >>44434104 #>>44436710 #
2. martypitt ◴[] No.44431859[source]
Diagrams look great - well done.

Reminds me of a similar project years ago that was doing the same thing - they ultimately struggled with monetization and folded (I forget the name) -- however this one is MIT OSS, so I'm guessing that's not a key concern right now.

Note that your "Built with the Isoflow library" link at the bottom to isoflow 404's to https://github.com/isoflow/isoflow

replies(1): >>44431941 #
3. x0z ◴[] No.44431941[source]
Thanks! I can't take any credit at all for the icons/design that's all Isoflow, but their community edition is designed to steer you to the pro version.

No plans at all for money making, just want people to enjoy using it.

Thank you for pointing out the link, I'll get on that ;)

replies(1): >>44433652 #
4. Animux ◴[] No.44432126[source]
If this could be hosted on GH pages, is there any demo link?
replies(1): >>44432185 #
5. x0z ◴[] No.44432185[source]
https://codesandbox.io/p/sandbox/github/markmanx/isoflow

^ ISOFLOW have an online demo you can use :)

6. zero0529 ◴[] No.44432712[source]
Can you export to other formats than JSON?
replies(1): >>44433052 #
7. 9dev ◴[] No.44432956[source]
This is a little tangential, but I've wondered for a while if there's a better way to visualise the composition of software systems.

Often, there's not only a single way to look at one: There's a user interaction flow through components, but those components also consist of hardware; the hardware might be virtual and composed of several, spread, sub-components, or even containers. You can go down this path pretty deep, and arrive at several different representations of the system that are either impossible to visualise at the same time, or make it incomprehensible.

Ideally, I would want to have a way to document different facets of the system individually, but linked to each other, and be able to change my perspective at anytime. This would allow to flip between UX, network traffic, firewall boundaries, program flow, logical RPC flow, and so on; all while being able to view connected components for a given component at anytime. For example, inspecting an application, then viewing its network ports, then its runtime container, the hypervisor the container runs on, the cloud provider that sits in, and so on.

My idea so far is a graph database that contains all components and the edges between them. The tool would have to be as extensible as possible, so using something like HCL to describe the graph would be great, with extensions for all kinds of components and edges. And finally a viewer to render visual representations of one or more composable layers to flick through, and export etc.

I never got around to working on it yet, but if anyone else had the same idea, I'd be open to collaborating :)

replies(5): >>44432990 #>>44433058 #>>44433063 #>>44433241 #>>44440325 #
8. alixanderwang ◴[] No.44432990[source]
At least for the layering + using text aspect, D2 support this:

defining diagrams as multiple layers like so

  x -> y

  layers: {
    inside_x: {
      a -> b
    }
  }
A fleshed out example hosted on our web service: https://app.terrastruct.com/diagrams/664641071
replies(3): >>44433688 #>>44433751 #>>44433913 #
9. x0z ◴[] No.44433052[source]
Which formats would you like to see?
replies(2): >>44433129 #>>44435024 #
10. billyp-rva ◴[] No.44433058[source]
There are quite a few tools that offer this model-based approach; you define your resources in a model, then use them in multiple perspectives to show different aspects like you describe. Some, like Ilograph[0] (my project), offer interactivity and zooming.

[0] https://www.ilograph.com

11. pjbk ◴[] No.44433059[source]
I always loved the isometric diagrams on Clive Maxfield's [1] books about electronics. Since a lot of circuits are non-planar (flip flops, semiconductor layers, FPGA architecture), adding a perspective view makes things uncluttered, and easier to understand and remember. I think it translates well to many technologies.

[1] https://www.clivemaxfield.com

12. x0z ◴[] No.44433063[source]
Some very good points, I totally agree, I suppose as you said you get to a point in your abstraction where it either loses meaning or becomes too complex to view. I think it would be a fantastic thing to try! Go build it!
13. typeofhuman ◴[] No.44433129{3}[source]
Not OC but I'd like iage (png/jpg)
14. progx ◴[] No.44433138[source]
Node version? Could not get it running with 22 or 24 on linux.
replies(3): >>44433294 #>>44433306 #>>44433369 #
15. ◴[] No.44433241[source]
16. pelagicAustral ◴[] No.44433294[source]
Got it working with no issues on v20.11.0
replies(1): >>44433316 #
17. x0z ◴[] No.44433306[source]
24.3 for me, whats the issue you're getting?
18. x0z ◴[] No.44433316{3}[source]
Good to know! Thanks :)
19. mmastrac ◴[] No.44433347[source]
This is awesome. I built a lightweight home status server called Stylus that would probably pair very well with this:

https://github.com/mmastrac/stylus

It works by automatically changing CSS classes, and it looks like the underlying isoflow library should support this.

replies(1): >>44440560 #
20. h1fra ◴[] No.44433365[source]
NB: it's using isoflow
21. BigJ1211 ◴[] No.44433369[source]
Works on 24.3.0 for me, though many a warning is thrown.
22. busssard ◴[] No.44433652{3}[source]
it would be great to have an easier time to add my custom icon svg or even links to svg and then scaling them automatically to size

this way i could tell the LLM that will be generating my JSON to include the following links as X and create the output JSON immediately

replies(1): >>44434819 #
23. aitchnyu ◴[] No.44433688{3}[source]
Wonder why Mermaid has more hype than this.
24. nullify88 ◴[] No.44433751{3}[source]
Whoa as an infrastructure guy I had always dreamed of diagrams like this. And while I've used Miro and some OSS homebrew stuff, nothing was as polished as this. Well done.
25. dr_kretyn ◴[] No.44433898[source]
"beautiful" here is definitely subjective. I only see a diagram and it looks like from PowerPoint presentation from the marketing team to the sales team.

Why JS world frequently uses "beautiful" or "modern" to describe its project? Often that hides something else.

replies(1): >>44433979 #
26. 9dev ◴[] No.44433913{3}[source]
Terrastruct looks really nice, and kind of like a 2D version of the 3D thing I'm thinking of; if you could attach key-value properties to nodes and vertices, and had different rendering modes that made use of any of these properties to render the item differently, that would probably be pretty close. For example, a layer that displays a physical network might only consider vertices with a `kind` attribute of "physical link"; that limits the layer to all nodes with a matching vertex between them, and the layer would also only display those attributes of the nodes relevant for the current view.

Does that make sense?

replies(1): >>44433940 #
27. alixanderwang ◴[] No.44433940{4}[source]
Yeah we do this with globs.

  a.class: backend
  b.class: frontend

  # hide everything
  **: suspend

  layers: {
     backend: {
       # show backend stuff
       **: unsuspend {
         &class: backend
       }
     }
  }

see more here: https://d2lang.com/blog/c4/
28. swalsh ◴[] No.44433979[source]
You can just not post if your criticism is mean spirited.
replies(1): >>44435725 #
29. donatj ◴[] No.44434045[source]
I am unclear exactly, what is this doing on top of Isoflow? Seems like Isoflow is doing a lot of the heavy lifting here?
replies(1): >>44434382 #
30. gtirloni ◴[] No.44434069[source]
This looks amazing. I find Mermaid.js ugly and the syntax difficult/buggy but unfortunately it's one of the best supported diagram tools in static site generators. It'd be awesome to have Isoflow diagrams embedded in Markdown like that.
replies(4): >>44434123 #>>44434127 #>>44434324 #>>44440290 #
31. lovelearning ◴[] No.44434104[source]
I'm not very familiar with Node.js. Any idea where in isoflow's code are the graphics for those 3D-style icons? Are they SVG or what? Is it possible to add custom icons?
replies(2): >>44436380 #>>44440156 #
32. cybrox ◴[] No.44434123[source]
I love the idea of mermaid but the syntax is somewhat convolutes and the integrations in tools like GitLab are very unstable.
replies(2): >>44438448 #>>44441348 #
33. x0z ◴[] No.44434127[source]
Thanks! That'd definitely be interesting to look into, I'll put it on my TODO
34. Yesman85 ◴[] No.44434145[source]
If it can consume terraform state and visualize it, that would be amazing.
replies(3): >>44434824 #>>44440305 #>>44442510 #
35. wooptoo ◴[] No.44434322[source]
There's also diagrams.mingrammer.com which is a fantastic tool.
36. mgoetzke ◴[] No.44434324[source]
Markdown integration would be really great.
replies(1): >>44441014 #
37. b0a04gl ◴[] No.44434340[source]
what if we can make these diagrams synchronized with reality. you need the diagram to pull from the same source of truth as your actual infrastructure - whether that's terraform state, kubernetes manifests, or service discovery. that way diagrams become less historical artifacts and more of living documentation
replies(3): >>44434366 #>>44434921 #>>44437220 #
38. x0z ◴[] No.44434366[source]
That's a great thought, I'd need to make some kind of translation between manifests and the json, getting knowledge of those relationships might be tricky? Service discovery is another route, would hate to get someones IT department angry for aggressive port scanning though lol
39. x0z ◴[] No.44434382[source]
No you're absolutely right, isoflow is doing 90% of the work here, I'm not hiding that, they just don't have a ready to use version like this of their community pack. That's all this is.
replies(1): >>44436737 #
40. knorker ◴[] No.44434661[source]
It's a bit confusing to see "openflow" diagrams that include network components, that have nothing to do with OpenFlow. https://en.wikipedia.org/wiki/OpenFlow

It is unrelated, right? Just a name clash with an overlapping domain?

replies(1): >>44434839 #
41. x0z ◴[] No.44434819{4}[source]
I'll add it to the todo
42. x0z ◴[] No.44434824[source]
It's on the list ;)
43. x0z ◴[] No.44434839[source]
Hahahah yes so funnily enough my dad works with the IETF, and I showed him this project and he said "I was really confused why you called it that when that's a standard" Might be due a rebrand already!
replies(2): >>44436025 #>>44436569 #
44. jamesponddotco ◴[] No.44434921[source]
Cloudcraft[1][2] can do that with your cloud provider, AWS or Azure. As a bonus, the diagrams also look quite cool.

[1]: https://www.cloudcraft.co/

[2]: I’m part of the Cloudcraft team at DataDog, so obviously, I’m biased.

replies(1): >>44434995 #
45. x0z ◴[] No.44434995{3}[source]
I absolutely love cloudcraft, full disclosure one of our team at work wanted to use it, but we're a public sector org(no money), so I threw this together for him
46. zero0529 ◴[] No.44435024{3}[source]
I think some Image formats or vector graphics would be cool!
47. fnord77 ◴[] No.44435314[source]
I'm inclined to agree with Edward Tufte - the 3D part doesn't add any information to the diagrams, so it is superfluous
replies(1): >>44435626 #
48. ◴[] No.44435373[source]
49. kingnothing ◴[] No.44435391[source]
If you care, Snowflake launched a product called Openflow less than a month ago. Yours will probably be very difficult to discover.
replies(1): >>44435773 #
50. StrangeOrange ◴[] No.44435626[source]
Interesting visuals change the way in which people engage with a diagram. You can think of it as an aspect of storytelling. Personally I find my eyes much more likely to be drawn to these isometric diagrams, compared to a 2D equivalence. The 3D aspect draws my eyes in and keeps them there. So what's being added doesn't need to be raw information that changes the facts of a diagram, it can be an aid to processing. There's a reason that visual design is a thing.
51. dr_kretyn ◴[] No.44435725{3}[source]
It wasn't mean spirited but now I can see it that indeed it came out as such. Apologies. And thanks for pointing it out!
replies(1): >>44437639 #
52. esseph ◴[] No.44435773[source]
There's also a network telemetry protocol called OpenFlow that every network engineer knows.

https://en.wikipedia.org/wiki/OpenFlow

replies(3): >>44437373 #>>44439082 #>>44441764 #
53. esseph ◴[] No.44436025{3}[source]
Definitely rebrand... This is going to confuse a lot of people!
54. rixed ◴[] No.44436380{3}[source]
I was curious also. The SVGs for the isoflow library of icons is in node_modules/@isoflow/isopacks/dist/isopacks.md

(yes, svg within base64 within markdown)

replies(1): >>44436545 #
55. mh- ◴[] No.44436545{4}[source]
Thank you for the parenthetical there. When I read your first line I thought, "surely they didn't.."

They did.

replies(1): >>44437234 #
56. mh- ◴[] No.44436569{3}[source]
I'm not one to pile onto the "you can't name it something that's already taken" comments, but given the name recognition within your target audience already, yeah. Plus, this will just be really hard to google.
57. ◴[] No.44436710[source]
58. smokel ◴[] No.44436737{3}[source]
You aren't hiding it, but the announcement and first paragraphs in the README suggest otherwise. It comes off as a bit disingenuous, perhaps you are not aware of this?
59. jayde2767 ◴[] No.44437105[source]
Pretty cool app, OP. Thanks for sharing the details.
60. oddlama ◴[] No.44437220[source]
I've written something like this for NixOS a while back [1], which generates infrastructure diagrams directly from the source of truth (albeit not as pretty as isoflow). I'm sure this could be applied to other declarative tech stacks aswell!

[1]: https://github.com/oddlama/nix-topology

61. gnatolf ◴[] No.44437234{5}[source]
Curious what's the argument for/against that here. I agree it's at least unusual.
replies(1): >>44437259 #
62. mh- ◴[] No.44437259{6}[source]
I don't have any good argument in either direction, if I'm being honest. Just feels.. weird.
63. foobiekr ◴[] No.44437373{3}[source]
I was going to note the same thing. The networking openflow is the first hit on google and bing; why do people not websearch?
replies(1): >>44437516 #
64. esseph ◴[] No.44437516{4}[source]
"OpenRouter" is another one that drives me nuts.

"You mean FRR?" https://frrouting.org/

65. MisterTea ◴[] No.44437639{4}[source]
Nah, its okay. I too think beautiful is used too often in contexts where it feels exaggerated. Nature can be beautiful. People can be beautiful. But a blue and grey computer diagram? It certainly looks good to me but I would not use the word beautiful. Perhaps if it were exceptionally artistic using a unique aesthetic I would use that word. But that's just like, my opinion, man.
replies(1): >>44442382 #
66. SOLAR_FIELDS ◴[] No.44438448{3}[source]
That's more of a takedown of whoever built the Gitlab tool than Mermaid itself.

In the world where LLM's are very good at mermaid diagrams is the syntax even that terribly important?

replies(1): >>44440011 #
67. burnt-resistor ◴[] No.44439082{3}[source]
This is immediately what I thought of. Terrible name collision.
68. EatFlamingDeath ◴[] No.44440011{4}[source]
What a terrible take
69. kevlened ◴[] No.44440156{3}[source]
The docs for the icons: https://isoflow.io/docs/isopacks

Collections of SVGs for the icons: https://github.com/markmanx/isopacks/tree/main/collections

70. Tsarp ◴[] No.44440290[source]
I had the same issue. I found this and it works decently well and OSS.

https://mermaid-to-excalidraw.vercel.app/

71. aqula ◴[] No.44440305[source]
This is something I'm working on. I'll probably do a separate post some time.

https://marketplace.visualstudio.com/items?itemName=infragra...

72. aqula ◴[] No.44440325[source]
Something like the C4 model?

https://c4model.com/diagrams

73. ram_rattle ◴[] No.44440326[source]
Looks dope, Thanks for doing this
74. Valodim ◴[] No.44440560[source]
Looks great! One recommendation, move the screenshots more to the top of the readme. It says "Stylus (style + status)" first sentence, and leaves the reader with a dangling "so what is the style?!" until way lower, after a theory of operation section ;)
replies(1): >>44444853 #
75. Valodim ◴[] No.44440850[source]
So if this can be hosted as a github page, why not make the "quick start" section a link to just use the PWA?
76. romeo88 ◴[] No.44441014{3}[source]
I’d argue even necessary for success.
77. LtdJorge ◴[] No.44441348{3}[source]
I don't know why, but I find the syntax pretty decent when you get used to it. It's declarative.
78. tankenmate ◴[] No.44441562[source]
FYI, they changed their name to FOSSFlow about an hour ago.
replies(1): >>44443803 #
79. liotier ◴[] No.44441764{3}[source]
Reading the title, I expected cute network diagrams from aggregated OpenFlow telemetry !
80. fennecbutt ◴[] No.44442382{5}[source]
Beauty is in the eye of the beholder.
81. soco ◴[] No.44442510[source]
And for the next level of wishful thinking, filter that Terraform state and show only main components...
replies(1): >>44456031 #
82. x0z ◴[] No.44443803[source]
Hahaha yes, after popular demmand I realised my mistake
83. mmastrac ◴[] No.44444853{3}[source]
Thanks for that feedback, will totally do that. I should probably update the sample screenshots to be a little more visually appealing, as well.
84. careful_ai ◴[] No.44453040[source]
Kudos—OpenFLOW feels like reclaiming infrastructure from CLI sprawl. Low-code network management with observability baked in is a powerful combo. The secret sauce is that it keeps humans in the loop: scripting flows is easy, but visualizing and validating them in real-time makes it production-ready. That human-checkpoint mindset is where dynamic tooling meets trust.
85. x0z ◴[] No.44456031{3}[source]
This is the first project I've had that's gained any traction, my todo is filling up so fast! Definitely want to make Terraform state imports a main