YABAL - Yet Another BPMN Auto Layout. Layout BPMN diagrams and generate missing DI information
npm install yet-another-bpmn-auto-layoutAutomated, intelligent layout for BPMN diagrams
Transform your BPMN XML files into beautifully organized diagrams with automatic layout algorithms. Perfect for developers, business analysts, and architects who need clear, readable process visualizations.



``bash`
npm install yet-another-bpmn-auto-layout
`javascript
import { layoutProcess } from 'yet-another-bpmn-auto-layout';
import diagramXML from './diagram.bpmn';
// Apply automatic layout to your BPMN diagram
const diagramWithLayoutXML = await layoutProcess(diagramXML);
console.log(diagramWithLayoutXML);
`
1. Clone and run the demo:
`bash`
git clone https://github.com/IvanTulaev/yet-another-bpmn-auto-layout.git
cd yet-another-bpmn-auto-layout
npm install
npm start
2. Open your browser (automatically launches at http://localhost:8080)
3. Use the interface:
- Upload your BPMN file (left panel, "Open" button)
- View the automatically laid out diagram
- Download the result (right panel, "Download" button)
`bashRun tests and view results in terminal
npm runt test
$3
`bash
Test grid layout functionality
npm run test ./test/GridSpec.js
`๐ Project Structure
Place test BPMN files in:
`
/test/fixtures/
`โ ๏ธ Current Limitations
The following BPMN elements are not currently auto-laid:
- Text annotations
- Groups
We're actively working to expand element support in future releases.
๐ Resources & Support
- Live Demo - Try it now
- GitHub Issues - Report bugs or request features
- npm Package -
yet-another-bpmn-auto-layout๐ License
Distributed under the MIT License. See
LICENSE` for more information.---
YABAL - Making BPMN diagrams readable, one layout at a time.