frontpage.
newsnewestaskshowjobs

Made with ♥ by @iamnishanth

Open Source @Github

fp.

Open in hackernews

Show HN: Diagram as code tool with draggable customizations

https://github.com/RohanAdwankar/oxdraw
161•RohanAdwankar•10h ago
In the past I've used declarative diagram generation tools like Mermaid.js a lot for quickly drawing up things but for presentations or deliverables I find that I have to then move the generated diagrams over to a tool like Lucidchart which allows full control of the organization and customization.

Therefore I am now working on this to combine the benefits of both into just one tool which can do both functions.

The project is certainly in the early stages but if you find yourself making architecture diagrams I'd love to hear your thoughts on the idea or even a Github issue for a feature request!

One of the workflows I'm targeting is when an AI generates the first draft of the diagram (all the LLMs know .mmd syntax) and then the user can then customize it to their liking which I think can drastically speed up making complex diagrams!

Comments

vanilla•9h ago
This looks like a very promising project, I have been looking for exactly this.

One feature I would love to see a declarative diagramming solution would support is a hover pop-up with more information or nested diagrams.

RohanAdwankar•9h ago
Thanks! I think that sounds interesting, to make sure I'm understanding your use case would these pop ups be for your own use or for other people? For example would you want to send a link to someone else on your team and then the link shows the diagram with popups and nesting? Or would it be sufficient to send over the .mmd files and then the other person can use the cli to open the web interface which supports the popups and nesting. I imagine I could add the latter one quickly but for the former I would either add an easy way for users to self serve like with ngrok or some cloud solution. Or alternatively I could add some way to export the diagram just as a standalone HTML file in which case that could be sent and support the popups and hovering without the person you're sending it to having to have the CLI installed.
vanilla•8h ago
ilograph [0] has these features. I think it should be possible with SVG only. The main use-case would be for documentation sites.

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

RohanAdwankar•7h ago
Thanks for sharing I'll look into this. The animations do look great!
anorak27•9h ago
Wonderful project.

There's also mermaidjs to excalidraw https://github.com/excalidraw/mermaid-to-excalidraw

RohanAdwankar•9h ago
This seems cool! Thanks for sharing.
huydotnet•9h ago
Wonderful! I have been wanting something like this for a really long time!
RohanAdwankar•9h ago
Thanks!
gurjeet•9h ago
Great job on the releasing the project; it definitely solves a need of being able to use declarative syntax for defining the relationships, and then customizing the layout which the regular layout generators can't do.

Project's Cargo.toml file says code is licensed under MIT license, but there's no license file in the repository, so Github doesn't show what the project is licensed under. Please add the license file so that people see it without having to dig through the code/configuration to determine that.

gurjeet•9h ago
If you wish to increase the adoption the tool, do consider hosting it to make it easy for people to use it. I see that it's heavily dependent on server-side code, so the cheap/free static hosting wouldn't be an option.
RohanAdwankar•9h ago
That makes sense I will eventually get to that!
RohanAdwankar•9h ago
Thanks for catching that! Just added the license file.
plmpsu•9h ago
I really wish PlantUML would just solve this jarring problem.
dixtel•9h ago
Very cool idea, this is exactly what I'm missing from mermaid. Thanks for sharing this!
dboreham•8h ago
Thank you.
hamburglar•8h ago
Just FYI your chosen example causes a little confusion in the context of “code tool” because I immediately thought, “is this thing an attempt at some kind of weird visual programming tool which is giving me the choice of Go, Python, and Rust? WTF?” But then I realized that was just sample data.
RohanAdwankar•8h ago
that would be pretty funny. A visual programming tool for polyglot microservice architectures XD
eagleinparadise•7h ago
This is awesome. I was looking for exactly this last week. A tool I could prompt AI to come up with an architecture and then be able to pick up manually, but visually not editing the code.

Being able to express a workflow or diagram and then have AI implement would be awesome to have a tight loop.

RohanAdwankar•2h ago
Great to hear! Absolutely this is the goal.
zmmmmm•7h ago
It's definitely much needed.

I use PlantUML for most diagramming but for anything with more than about 5 components in it I'm spending 20-30% of my time desperately trying to tweak the layout with hints.

It's an interesting approach to embed comments and then build that into the layout engine. I've always thought it would solve a lot of my issues if I could just lock the coordinates for certain components and then let the layout engine do the rest with those as hard constraints. This looks like something similar to that approach.

I really want this because the alternative is to spill over to completely manually maintained diagrams using GUI tools which then can't be easily integrated with source control - I want the same commit that changes the code to also change the architecture diagram for that code. Then it is part of code review and integrates to the whole process well.

Anduia•20m ago
I use PlantUML because it renders in GitLab's markdown, including wikis, MD docs and even PR comments. However, I have to use Mermaid for projects hosted on GitHub.

The hassle of tweaking the layout in puml, such as pairing elements with an invisible connections and groups, adding or removing dashes from the arrows in class diagrams... is gone because Mermaid is simply inferior in that sense.

Mermaid always feels like it's in beta and I don't understand why GitHub ignores the request to support puml (1). It seems that adoption of diagrams as code is tied to what is supported by major vendors and they don't care enough. Or maybe it is because mermaidchart made an official vscode plugin, who knows.

While I agree that improvements are needed, I'm not convinced that creating a third standard is the answer. What I would like is to be able to assign weights to my elements and let the renderer do the work (not set x and y coordinates like in oxdraw).

[1] https://github.com/orgs/community/discussions/10111

monkeycantype•7h ago
Hello Rohan. This is really great. If you are able to include parameters to expose the intermediate data as inputs and outputs, so that this can be run to a step in the process and output the data, or run from a step with pre-prepared data. It would mean that other people could build on what you've done to create other diagrams and renderings.
RohanAdwankar•2h ago
Hi thanks! I'm not sure I fully understand what you mean by intermediate data? Would this be the location data computed for the different components?
halostatue•6h ago
I've made a private MacPorts port[1]; if I find that I use it frequently enough, I might contribute it to the main MacPorts port repo[2].

One thing that's missing from my perspective (and this is probably true for Homebrew packaging as well, but I don't do that) is Git tags / GitHub releases associated with your Cargo releases.

I can work around it for now by using an explicit release (`9ccd9bf53f9a309ccda42b5c17e9c1056493fb90` is what I'm assuming was your 0.1.0 release point).

I've also assumed that npm10 is sufficient (which currently installs node22 on MacPorts).

[1] https://github.com/halostatue/ports

[2] https://github.com/macports/macports-ports

[3] https://github.com/halostatue/ports/commit/e7331a7fcae362b0d...

RohanAdwankar•2h ago
Thankyou!
metmac•4h ago
I really wish Mermaid would just ratify a layout spec. Make it optional. Use it. Great. Don’t use it. The layout engine does its thing.
benblu•4h ago
Thank you! Very cool.

I don't see a button for it (on mobile currently, and will check thoroughly at my computer) -- is there a button to add a node?

Another feature I've always craved for code diagramming is "collapse downstream nodes" -- though it might be outside of your scope (and mermaids?).

RohanAdwankar•2h ago
Hi as of now I haven't added that feature so the current way would be to edit the .mmd text. However I think you are right that would be a good feature to add. For collapsing downstream nodes I think it would make sense with the request the someone else made in this thread for animations. From what I see it should certainly be possible to implement at some point!
liqilin1567•3h ago
Great project, I've been generating diagrams with llm for a while, and I often struggle to refine layout through the model.

But now I can interactively make changes to the diagram with this, it's very productive.

RohanAdwankar•3h ago
Thank you! Happy to hear that!
newusertoday•2h ago
i generally use plantuml in emacs for generating diagrams from text but it does not allows for drag and drop editing. This looks cool.
lmeyerov•2h ago
Is this embeddable, eg, a react component that can be hooked into?

The lack of this has been a sticking point making us lean to dropping mermaid, so very cool to see!

RohanAdwankar•1h ago
Oh thanks, that's a good idea I'll make a issue on the github for that and get to it eventually!
dackdel•2h ago
isint tldraw an alternative to this
RohanAdwankar•2h ago
I can look into this further but at a glance I don't see something for declarative diagramming syntax. I will say the name is fantastic! One of the great things about making this thread for me was learning about all the different tools people are using!
parentheses•2h ago
This looks really cool! Next diagram is getting this treatment!
RohanAdwankar•2h ago
Thanks, let me know how it goes! There's certainly lots of improvements to be made to the layout engine and polishing for the UI so happy to incorporate any feedback!

Show HN: I built an SDK to select the best model for your task

https://github.com/Mikethebot44/autorouter-package
1•mjupp1•6m ago•0 comments

66 million-year-old dinosaur ‘mummy’ skin was actually a perfect clay mask

https://www.cnn.com/2025/10/23/science/duck-billed-dinosaur-mummy-clay-mask
1•breve•8m ago•0 comments

Forgejo v13.0.2 contains critical security fixes

https://codeberg.org/forgejo/forgejo/src/branch/forgejo/release-notes-published/13.0.2.md
1•kassner•11m ago•1 comments

Washington lawyer on furlough lives out dream of running a hot dog cart

https://www.reuters.com/world/us/washington-lawyer-furlough-lives-out-dream-running-hot-dog-cart-...
2•hansmayer•13m ago•1 comments

GenAI Image Editing Showdown

https://genai-showdown.specr.net/image-editing
2•Hard_Space•24m ago•0 comments

Show HN: Project Journal – Give AI coding assistants persistent memory

https://github.com/CursorWP/ai-project-journal
1•CursorWP•26m ago•0 comments

Sandbox Your Program Using FreeBSD's Capsicum [video]

https://www.youtube.com/watch?v=Ne4l5U_ETAw
1•todsacerdoti•26m ago•0 comments

TIL: Figma provides a helper function for gradient transforms

https://wpconverters.com/demystifying-figmas-gradient-transformations-a-developers-guide
1•drzivil•31m ago•1 comments

Scientists are racing to grow human teeth in the lab

https://www.cnn.com/science/lab-grown-human-teeth-spc
1•breve•33m ago•0 comments

We want to move Ruby forward

https://andre.arko.net/2025/10/26/we-want-to-move-ruby-forward/
3•ciconia•36m ago•0 comments

The Magic of Precision Engineering

https://www.hightechinstitute.nl/the-magic-of-precision-engineering/
2•o4c•58m ago•1 comments

Gluing and framing a 9000-piece jigsaw

https://river.me/blog/puzzle-glue-9000/
1•busymom0•1h ago•0 comments

AI Pullback Has Officially Started

https://www.planetearthandbeyond.co/p/ai-pullback-has-officially-started
4•danfritz•1h ago•0 comments

Lampedusa's 1958 Novel The Leopard skewered the super-rich

https://www.bbc.com/culture/article/20250304-the-leopard-the-1958-italian-novel-that-skewered-the...
1•walterbell•1h ago•0 comments

Practical Defenses Against Technofascism

https://micahflee.com/practical-defenses-against-technofascism/
3•HotGarbage•1h ago•0 comments

The Magna Anima Genius Project

https://magnaanimageniusproject.substack.com/
1•jbutlergenius•1h ago•0 comments

Raster Master v5.4 Sprite/Tile/Map Editor 88 Stars on GitHub

https://github.com/RetroNick2020/raster-master/releases/tag/v5.4R121
3•retronick2020•1h ago•0 comments

Salesforce Enterprise Deep Research

https://github.com/SalesforceAIResearch/enterprise-deep-research
2•Raven603•1h ago•2 comments

Operating Systems Written in Free Pascal

https://wiki.freepascal.org/Operating_Systems_written_in_FPC
2•kristianp•1h ago•0 comments

Sustained western growth and Artificial Intelligence

https://datagubbe.se/llmfix/
2•brazukadev•1h ago•0 comments

Tell HN: Don't Vibe Your Design

2•davidtranjs•1h ago•1 comments

Hey LLM, write production-ready code

https://wejn.org/2025/10/llm-write-production-ready-code/
1•wejn•2h ago•1 comments

Student Handcuffed After School's AI System Mistakes a Bag of Chips for a Gun

https://www.theguardian.com/us-news/2025/oct/24/baltimore-student-ai-gun-detection-system-doritos
4•m463•2h ago•0 comments

Show HN: I analyzed 3,465 remote job listings – 72% hide salary information

https://no-commute-jobs.com/blog/remote-work-statistics-2025
1•remimatteo•2h ago•1 comments

Why bosses need to wake up to dark patterns

https://www.economist.com/business/2025/10/16/why-bosses-need-to-wake-up-to-dark-patterns
1•Austin_Conlon•2h ago•0 comments

The Layer 1 Blockchain Built for AI Agent

https://harvestai.co/
1•salkahfi•2h ago•1 comments

Success Always Spawns Haters

https://world.hey.com/dhh/success-always-spawns-haters-75edaede
1•doppp•2h ago•0 comments

DHS Posts Video Featuring Song Popular with Nazi Creators

https://gizmodo.com/dhs-little-dark-age-nazi-video-2000676359
2•nobody9999•2h ago•1 comments

Language Modeling with Hierarchical Reasoning Models: Lessons from 1M Parameters

https://williamthurston.com/ml/language-models/transformers/2025/10/25/language-modeling-with-hie...
2•jhspaybar•2h ago•0 comments

GameStop Declares Console Wars Over

https://twitter.com/gamestop/status/1982213786221109263
2•avonmach•2h ago•1 comments