About This Resource

reladraw is an open-source text language for creating diagrams where positions are specified relatively (e.g., 'below app.ui' or 'right of app') rather than with absolute coordinates. The project positions itself between declarative diagram languages like Mermaid, Graphviz, and D2, which auto-place elements, and tools like draw.io or Excalidraw that require manual placement. It includes a parser, layout engine, and SVG renderer written in TypeScript with zero runtime dependencies, plus a CLI that converts .reladraw files to SVG. Version 0.8.0 is an early-stage release; the language syntax is not yet stable. A skill can be installed for AI coding agents such as Claude Code, Codex, Cursor, and Copilot via npx skills add. Licensed under Apache-2.0, the repository has 490 stars and 6 forks, with a project site at reladraw.github.io/reladraw/.