Reladraw Wants to Fix Diagramming's Tradeoff Between Auto-Layout and Manual Control

A developer has released Reladraw, an open-source diagram language that tries to split the difference between automatic layout tools like Mermaid and Graphviz and manual editors like Draw.io. The project, posted to Hacker News under a Show HN thread that drew 167 points and 47 comments, lets users define a diagram in a text-based language while keeping direct control over where individual elements sit. A browser playground on the project's GitHub page allows testing without any local installation.

The problem Reladraw targets is familiar to anyone who has wired up a flowchart or architecture sketch. Automatic-placement tools are fast but impose their own layout decisions, while drag-and-drop editors offer precision at the cost of time, especially when a diagram needs frequent updates. Reladraw's answer is a declarative format in which structure and positioning are both expressible, so a diagram can be regenerated from source without losing the author's intended arrangement.

The project also courts a less traditional audience: AI agents. According to the developer, manual diagramming software is inefficient for agents to manipulate, since it relies on GUI interaction rather than text edits. By making diagrams addressable as code, Reladraw aims to give tools like Claude a way to read, generate, and modify diagrams directly. The repository includes setup instructions for an npm install as well as a skill package intended for use with Claude or other agent frameworks.

That dual-purpose framing places Reladraw in a growing category of developer tools designed from the start for machine editing as well as human reading. Text-based formats such as Mermaid have already become common in documentation pipelines because they diff cleanly in version control, but their layout engines remain largely opaque to users. Reladraw's pitch is that retaining placement control does not have to mean abandoning the reproducibility that made those formats popular.

Whether the language's syntax stays approachable once diagrams grow past a handful of nodes is the main question the comment thread appears to be probing. The playground and npm package give prospective users a low-cost way to test that, and the agent skill offers a second path for teams already automating documentation work. The developer has not announced a formal release schedule or roadmap beyond the current repository.

For now, Reladraw is available as source, with no installation required to try the playground. The next signal will be whether users adopt it for real diagrams rather than demos, and whether the agent integration produces edits that hold up outside a controlled example. Those two tests will decide if the project's middle-ground approach sticks.