# romanvoronovskiy/dbml_diagram architecture

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

- Interactive diagram: https://gitdiagram.com/romanvoronovskiy/dbml_diagram
- Repository: https://github.com/romanvoronovskiy/dbml_diagram

## Overview

DBML Diagram is an offline IntelliJ plugin for viewing and editing schema diagrams from `.dbml` files. The main workflow is opening a DBML file, parsing it, laying out its schema, rendering SVG, and presenting an interactive preview; users can also export diagrams and dialect-specific DDL. The graph includes the documented language support, stored manual layout, and database export branches. Some source is unsampled, so workflow links rely on README statements where implementation calls are not visible.

Main entry points: [`dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/editor/DbmlPreviewEditor.kt`](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/editor/DbmlPreviewEditor.kt) (Preview editor), [`dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/RenderScheduler.kt`](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/RenderScheduler.kt) (Render scheduler), [`dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/DdlDialect.kt`](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/DdlDialect.kt) (DDL dialects), [`dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/PreviewHtml.kt`](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/PreviewHtml.kt) (Preview UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ide["IDE integration"]
  node_language["DBML language<br/>[DbmlLanguage.kt]"]
  node_editor["Preview editor"]
end

subgraph group_core["Schema pipeline"]
  node_parser["Tolerant parser"]
  node_model["Schema model<br/>[DbmlModel.kt]"]
  node_layout["Layered layout"]
  node_svg["SVG renderer"]
end

subgraph group_preview["Preview and layout"]
  node_scheduler["Render scheduler<br/>[RenderScheduler.kt]"]
  node_html["Preview UI<br/>[PreviewHtml.kt]"]
  node_positions["Position store"]
end

subgraph group_export["Export"]
  node_exporter["Diagram exporter<br/>[DiagramExporter.kt]"]
  node_dialect["DDL dialects<br/>[DdlDialect.kt]"]
  node_mysql["MySQL DDL"]
  node_postgres["PostgreSQL DDL"]
  node_oracle["Oracle DDL"]
end

node_user(("IDE user"))
node_dbml["DBML file"]
node_sqlfile["SQL export"]
node_imagefile["SVG / PNG export"]

node_user -->|"opens or edits"| node_dbml
node_dbml -->|"recognized as"| node_language
node_dbml -->|"opens in"| node_editor
node_editor -->|"schedules rendering"| node_scheduler
node_scheduler -->|"parses text"| node_parser
node_parser -->|"produces schema"| node_model
node_scheduler -->|"requests layout"| node_layout
node_scheduler -->|"requests rendering"| node_svg
node_editor -->|"updates preview"| node_html
node_svg -->|"displays SVG"| node_html
node_editor -->|"loads and saves"| node_positions
node_html -->|"sends edits"| node_positions
node_user -->|"exports diagram"| node_editor
node_editor -->|"requests export"| node_exporter
node_exporter -->|"writes SVG or PNG"| node_imagefile
node_user -->|"exports DDL"| node_editor
node_editor -->|"selects dialect"| node_dialect
node_dialect -->|"selects generator"| node_mysql
node_dialect -->|"selects generator"| node_postgres
node_dialect -->|"selects generator"| node_oracle
node_editor -->|"generates selected DDL"| node_mysql
node_editor -->|"generates selected DDL"| node_postgres
node_editor -->|"generates selected DDL"| node_oracle
node_editor -->|"saves SQL"| node_sqlfile

click node_language "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/language/DbmlLanguage.kt"
click node_editor "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/editor/DbmlPreviewEditor.kt"
click node_scheduler "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/RenderScheduler.kt"
click node_parser "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/parser/TolerantDbmlParser.kt"
click node_model "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/model/DbmlModel.kt"
click node_layout "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/layout/LayeredDiagramLayoutEngine.kt"
click node_svg "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/renderer/SvgDiagramRenderer.kt"
click node_html "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/PreviewHtml.kt"
click node_positions "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/DiagramPositionStore.kt"
click node_exporter "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/DiagramExporter.kt"
click node_dialect "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/DdlDialect.kt"
click node_mysql "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/MySqlDdlGenerator.kt"
click node_postgres "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/PostgreSqlDdlGenerator.kt"
click node_oracle "https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/OracleDdlGenerator.kt"

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_language,node_editor,node_user toneBlue
class node_parser,node_model,node_layout,node_svg toneAmber
class node_scheduler,node_html,node_positions toneMint
class node_exporter,node_dialect,node_mysql,node_postgres,node_oracle toneRose
class node_dbml,node_sqlfile,node_imagefile toneIndigo
```

## Components

### IDE integration

- [DBML language](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/language/DbmlLanguage.kt): `dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/language/DbmlLanguage.kt`
- [Preview editor](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/editor/DbmlPreviewEditor.kt): `dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/editor/DbmlPreviewEditor.kt`

### Schema pipeline

- [Tolerant parser](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/parser/TolerantDbmlParser.kt): `dbml-core/src/main/kotlin/io/github/dbmldiagram/core/parser/TolerantDbmlParser.kt`
- [Schema model](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/model/DbmlModel.kt): `dbml-core/src/main/kotlin/io/github/dbmldiagram/core/model/DbmlModel.kt`
- [Layered layout](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/layout/LayeredDiagramLayoutEngine.kt): `dbml-core/src/main/kotlin/io/github/dbmldiagram/core/layout/LayeredDiagramLayoutEngine.kt`
- [SVG renderer](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/renderer/SvgDiagramRenderer.kt): `dbml-core/src/main/kotlin/io/github/dbmldiagram/core/renderer/SvgDiagramRenderer.kt`

### Preview and layout

- [Render scheduler](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/RenderScheduler.kt): `dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/RenderScheduler.kt`
- [Preview UI](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/PreviewHtml.kt): `dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/PreviewHtml.kt`
- [Position store](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/DiagramPositionStore.kt): `dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/DiagramPositionStore.kt`

### Export

- [Diagram exporter](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/DiagramExporter.kt): `dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/DiagramExporter.kt`
- [DDL dialects](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/DdlDialect.kt): `dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/DdlDialect.kt`
- [MySQL DDL](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/MySqlDdlGenerator.kt): `dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/MySqlDdlGenerator.kt`
- [PostgreSQL DDL](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/PostgreSqlDdlGenerator.kt): `dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/PostgreSqlDdlGenerator.kt`
- [Oracle DDL](https://github.com/romanvoronovskiy/dbml_diagram/blob/main/dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/OracleDdlGenerator.kt): `dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/OracleDdlGenerator.kt`

### Other components

- **IDE user**
- **DBML file**
- **SQL export**
- **SVG / PNG export**

## Connections

- IDE user → DBML file: opens or edits (evidence: `README.md`)
- DBML file → DBML language: recognized as (evidence: `README.md`)
- DBML file → Preview editor: opens in (evidence: `README.md`)
- Preview editor → Render scheduler: schedules rendering (evidence: `dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/editor/DbmlPreviewEditor.kt`)
- Render scheduler → Tolerant parser: parses text (evidence: `README.md`)
- Tolerant parser → Schema model: produces schema (evidence: `README.md`)
- Render scheduler → Layered layout: requests layout (evidence: `README.md`)
- Render scheduler → SVG renderer: requests rendering (evidence: `README.md`)
- Preview editor → Preview UI: updates preview (evidence: `dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/editor/DbmlPreviewEditor.kt`)
- SVG renderer → Preview UI: displays SVG (evidence: `README.md`)
- Preview editor → Position store: loads and saves (evidence: `dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/editor/DbmlPreviewEditor.kt`)
- Preview UI → Position store: sends edits (evidence: `dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/preview/PreviewHtml.kt`)
- IDE user → Preview editor: exports diagram (evidence: `README.md`)
- Preview editor → Diagram exporter: requests export (evidence: `dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/editor/DbmlPreviewEditor.kt`)
- Diagram exporter → SVG / PNG export: writes SVG or PNG (evidence: `README.md`)
- IDE user → Preview editor: exports DDL (evidence: `README.md`)
- Preview editor → DDL dialects: selects dialect (evidence: `dbml-intellij-plugin/src/main/kotlin/io/github/dbmldiagram/plugin/editor/DbmlPreviewEditor.kt`)
- DDL dialects → MySQL DDL: selects generator (evidence: `dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/DdlDialect.kt`)
- DDL dialects → PostgreSQL DDL: selects generator (evidence: `dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/DdlDialect.kt`)
- DDL dialects → Oracle DDL: selects generator (evidence: `dbml-core/src/main/kotlin/io/github/dbmldiagram/core/ddl/DdlDialect.kt`)
- Preview editor → MySQL DDL: generates selected DDL (evidence: `README.md`)
- Preview editor → PostgreSQL DDL: generates selected DDL (evidence: `README.md`)
- Preview editor → Oracle DDL: generates selected DDL (evidence: `README.md`)
- Preview editor → SQL export: saves SQL (evidence: `README.md`)
