Skip to content

umlimatorArchitecture maps you can click through

Layered maps and 28 diagram types from one JSON model. An ES module with no dependencies, a CLI and a GitHub Action.

A live map ​

This is the Umlimator Atlas, umlimator's own model, drawn on this page by <umlimator-map>. Click a card to select it, and open a stacked card to go one level down. Open it full size, or browse the examples: every diagram type and the Atlas.

Install ​

bash
npm install umlimator
html
<script type="module">
  import { render } from 'https://cdn.jsdelivr.net/npm/umlimator@0.44.0/lib/umlimator.js';
</script>
bash
# Python 3.9+; Chrome or Chromium for pictures and checks
git clone --depth 1 --branch v0.44.0 https://github.com/zintaen/umlimator.git
python3 umlimator/umlimator.py render model.json --out page.html
yaml
# .github/workflows/maps.yml: what each pull request changes in your maps, posted on it
on: pull_request
permissions: { contents: read, pull-requests: write }
jobs:
  maps:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: zintaen/umlimator@v0.44.0
bash
# an MCP server over stdio, for an AI assistant such as Claude Code
claude mcp add umlimator -- python3 /path/to/umlimator.py mcp /path/to/model.json

Then draw a model into any element:

js
import { render } from 'umlimator';
import 'umlimator/theme.css';

const map = render(document.getElementById('map'), model);
map.update(nextModel);   // redraws only what changed, keeping the view, camera and selection

Getting started walks through a first model, and the API reference lists every export.

Support ​

umlimator is free and MIT licensed. Questions go to GitHub Discussions, and if it saves you time, you can support its development on Buy Me a Coffee or through GitHub Sponsors.

Released under the MIT License. Not affiliated with, endorsed by or sponsored by Amazon Web Services, Google or Microsoft.