# jgraph/drawio-desktop architecture

> Architecture diagram of the GitHub repository jgraph/drawio-desktop, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jgraph/drawio-desktop
- Repository: https://github.com/jgraph/drawio-desktop

## Overview

drawio-desktop is an Electron shell for the draw.io diagram editor. Users open or create diagrams in the editor, then save or export them; the desktop main process mediates windows, files, CLI requests, and renderer communication. Separate branches provide command-line batch export, embedded-diagram recovery, file-change watching, and update handling. The editor itself is a Git submodule and is not present in the supplied tree. Edges are limited to relationships shown in the README or the source index; unsampled wiring is omitted.

Main entry points: [`src/main/electron.js`](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/electron.js) (Electron main process), [`src/main/pdf-xml.js`](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/pdf-xml.js) (PDF diagram reader), [`src/main/png-xml.js`](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/png-xml.js) (PNG diagram reader), [`src/main/args.js`](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/args.js) (CLI argument parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Desktop runtime"]
  node_electron["Electron main process<br/>[electron.js]"]
  node_preload["Renderer preload"]
  node_cli["CLI argument parser<br/>[args.js]"]
  node_window["Window bounds<br/>[window-bounds.js]"]
  node_systempath["System path helper<br/>[system-path.js]"]
  node_progress["Progress window<br/>[progress-bar.js]"]
end

subgraph group_files["Diagram files"]
  node_watcher["File watcher<br/>[file-watcher.js]"]
  node_backup["Backup writer<br/>[backup-file.js]"]
end

subgraph group_exports["Export and recovery"]
  node_exportfiles["CLI file discovery<br/>[export-files.js]"]
  node_htmlexport["HTML export builder<br/>[html-export.js]"]
  node_pngxml["PNG diagram reader<br/>[png-xml.js]"]
  node_pdfxml["PDF diagram reader<br/>[pdf-xml.js]"]
  node_print["Print options<br/>[print-options.js]"]
end

subgraph group_updates["Updates and settings"]
  node_config["Config paths<br/>[config-paths.js]"]
  node_urlparams["Editor URL parameters<br/>[url-params.js]"]
  node_updatemode["Update mode<br/>[update-mode.js]"]
  node_updatechannel["Update channel<br/>[update-channel.js]"]
  node_disableupdate["Update disabling<br/>[disableUpdate.js]"]
end

node_user(("User"))
node_editor["Draw.io editor"]
node_filesystem[("Local files")]
node_updatehost["GitHub and S3 updates"]

node_user -->|"launches"| node_electron
node_electron -->|"hosts editor"| node_editor
node_electron -->|"parses arguments"| node_cli
node_electron -->|"restores bounds"| node_window
node_electron -->|"watches files"| node_watcher
node_electron -->|"writes backups"| node_backup
node_electron -->|"uses config paths"| node_config
node_electron -->|"loads parameters"| node_urlparams
node_electron -->|"handles CLI exports"| node_exportfiles
node_electron -->|"builds HTML export"| node_htmlexport
node_electron -->|"reads PNG diagrams"| node_pngxml
node_electron -->|"reads PDF diagrams"| node_pdfxml
node_electron -->|"gets print options"| node_print
node_electron -->|"resolves system path"| node_systempath
node_electron -->|"shows progress"| node_progress
node_electron -->|"selects update mode"| node_updatemode
node_electron -->|"uses update channel"| node_updatechannel
node_electron -->|"checks disable policy"| node_disableupdate
node_electron -->|"reads and writes"| node_filesystem
node_pdfxml -->|"uses inflate limit"| node_pngxml
node_electron -->|"checks and downloads"| node_updatehost
node_editor -.->|"opens and saves"| node_filesystem

click node_electron "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/electron.js"
click node_preload "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/electron-preload.js"
click node_cli "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/args.js"
click node_window "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/window-bounds.js"
click node_watcher "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/file-watcher.js"
click node_backup "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/backup-file.js"
click node_config "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/config-paths.js"
click node_urlparams "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/url-params.js"
click node_exportfiles "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/export-files.js"
click node_htmlexport "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/html-export.js"
click node_pngxml "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/png-xml.js"
click node_pdfxml "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/pdf-xml.js"
click node_print "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/print-options.js"
click node_systempath "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/system-path.js"
click node_progress "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/progress-bar.js"
click node_updatemode "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/update-mode.js"
click node_updatechannel "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/update-channel.js"
click node_disableupdate "https://github.com/jgraph/drawio-desktop/blob/dev/src/main/disableUpdate.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_electron,node_preload,node_cli,node_window,node_systempath,node_progress,node_user toneBlue
class node_watcher,node_backup,node_filesystem toneAmber
class node_exportfiles,node_htmlexport,node_pngxml,node_pdfxml,node_print toneMint
class node_config,node_urlparams,node_updatemode,node_updatechannel,node_disableupdate toneRose
class node_editor,node_updatehost toneIndigo
```

## Components

### Desktop runtime

- [Electron main process](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/electron.js): `src/main/electron.js`
- [Renderer preload](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/electron-preload.js): `src/main/electron-preload.js`
- [CLI argument parser](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/args.js): `src/main/args.js`
- [Window bounds](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/window-bounds.js): `src/main/window-bounds.js`
- [System path helper](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/system-path.js): `src/main/system-path.js`
- [Progress window](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/progress-bar.js): `src/main/progress-bar.js`

### Diagram files

- [File watcher](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/file-watcher.js): `src/main/file-watcher.js`
- [Backup writer](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/backup-file.js): `src/main/backup-file.js`

### Export and recovery

- [CLI file discovery](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/export-files.js): `src/main/export-files.js`
- [HTML export builder](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/html-export.js): `src/main/html-export.js`
- [PNG diagram reader](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/png-xml.js): `src/main/png-xml.js`
- [PDF diagram reader](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/pdf-xml.js): `src/main/pdf-xml.js`
- [Print options](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/print-options.js): `src/main/print-options.js`

### Updates and settings

- [Config paths](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/config-paths.js): `src/main/config-paths.js`
- [Editor URL parameters](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/url-params.js): `src/main/url-params.js`
- [Update mode](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/update-mode.js): `src/main/update-mode.js`
- [Update channel](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/update-channel.js): `src/main/update-channel.js`
- [Update disabling](https://github.com/jgraph/drawio-desktop/blob/dev/src/main/disableUpdate.js): `src/main/disableUpdate.js`

### Other components

- **User**
- **Draw.io editor**
- **Local files**
- **GitHub and S3 updates**

## Connections

- User → Electron main process: launches (evidence: `README.md`)
- Electron main process → Draw.io editor: hosts editor (evidence: `README.md`)
- Electron main process → CLI argument parser: parses arguments (evidence: `src/main/electron.js`)
- Electron main process → Window bounds: restores bounds (evidence: `src/main/electron.js`)
- Electron main process → File watcher: watches files (evidence: `src/main/electron.js`)
- Electron main process → Backup writer: writes backups (evidence: `src/main/electron.js`)
- Electron main process → Config paths: uses config paths (evidence: `src/main/electron.js`)
- Electron main process → Editor URL parameters: loads parameters (evidence: `src/main/electron.js`)
- Electron main process → CLI file discovery: handles CLI exports (evidence: `src/main/electron.js`)
- Electron main process → HTML export builder: builds HTML export (evidence: `src/main/electron.js`)
- Electron main process → PNG diagram reader: reads PNG diagrams (evidence: `src/main/electron.js`)
- Electron main process → PDF diagram reader: reads PDF diagrams (evidence: `src/main/electron.js`)
- Electron main process → Print options: gets print options (evidence: `src/main/electron.js`)
- Electron main process → System path helper: resolves system path (evidence: `src/main/electron.js`)
- Electron main process → Progress window: shows progress (evidence: `src/main/electron.js`)
- Electron main process → Update mode: selects update mode (evidence: `src/main/electron.js`)
- Electron main process → Update channel: uses update channel (evidence: `src/main/electron.js`)
- Electron main process → Update disabling: checks disable policy (evidence: `src/main/electron.js`)
- Electron main process → Local files: reads and writes (evidence: `src/main/electron.js`)
- PDF diagram reader → PNG diagram reader: uses inflate limit (evidence: `src/main/pdf-xml.js`)
- Electron main process → GitHub and S3 updates: checks and downloads (evidence: `README.md`)
- Draw.io editor → Local files: opens and saves
