Workflow

Recommended Order

1. Edit the native .drawio file.
2. Keep the .drawio file in the repository as the editable source.
3. Export only the artifact formats the user needs.
4. Run SVG lint when the diagram has meaningful routing or text density.
5. Visually inspect the result before you ship it.

Export Commands

PNG

node scripts/export-drawio.mjs architecture.drawio --format png --open

SVG

node scripts/export-drawio.mjs architecture.drawio --format svg

PDF

node scripts/export-drawio.mjs architecture.drawio --output architecture.drawio.pdf

When To Run Lint

Run lint after SVG export when:

• arrows route around multiple boxes
• non-rect shapes such as document, hexagon, parallelogram, or trapezoid sit close to arrows or frames
• labels are long or mixed-language
• boxes are packed tightly
• you need repeatable QA in CI

Lint Command

node scripts/check-drawio-svg-overlaps.mjs architecture.drawio.svg

What The Linter Reports

• edge-edge
• edge-rect-border
• edge-shape-border
• edge-rect
• rect-shape-border
• text-overflow(width)
• text-overflow(height)

AWS Icon Search

uv run python scripts/find_aws_icon.py eventbridge

Use the helper when diagram work depends on current AWS icon naming and you need a quick repository-local lookup.