> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://docs.brainframe.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Diagram Editor

# 🖼️ **Diagram Editor**  
> **"Design diagrams your way."**  
> *Go beyond automatic dependency graphs with a fully integrated editor.*  

---

## 1️⃣ Why Use the Diagram Editor?  
While Brainframe can **auto-generate dependency visualizations** (see [Dependency Tracking](https://docs.brainframe.com/en/article/dependency-tracking-1f1x6ax/)), sometimes you need **full design control**.  

📌 That’s why Brainframe integrates the open-source tool **Draw.io** — allowing you to create and edit diagrams directly inside Brainframe.  
* All changes are saved automatically.  
* Versioning works just like any other document.  

---

## 2️⃣ Creating a New Diagram  
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-08-at-11085_q8wn64.png =257xauto)
1. Click **New** and select the **Diagram** icon.  
2. Enter a **title** for your diagram.  
3. A new **Diagram/Flow chart document** is created and opened in the integrated Draw.io editor.  
![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/1_1hmld6n.png =676xauto)
Inside the Draw.io editor, you’ll find:  
1. **Toolbox** – Shapes and elements to drag onto the canvas.  
2. **Drawing board** – Main workspace to design diagrams.  
3. **Format panel** – Customise elements (size, colour, labels, etc.).  
4. **Auto-save** – Automatically saves after a few seconds (without creating a new version).  
5. **Create new version** – Manually save a timestamped version.  
6. **Version list** – View all saved versions for audit tracking.  

📌 *Use **manual versions** to mark milestones in your diagram’s lifecycle.*  

---

## 3️⃣ Adding Diagrams to Existing Documents  
You can also attach diagrams to existing files using the **folder content action menu**.  

Example: Adding a **process flow diagram** to a Word file for context.  

![](https://storage.crisp.chat/users/helpdesk/website/-/3/f/2/6/3f26ce462760bc00/screenshot-2026-07-08-at-11153_1cdx203.png =614xauto)
| Did you know that inside the OnlyOffice editor, Brainframe also integrates Draw.io. This lets you add and maintain diagrams directly inside Word docs — no need to switch tools.  

---

## 4️⃣ Best Practices  
* 📌 Use Draw.io for **process flows** and **architecture diagrams** on top of those generated by auto-dependency graphs for complete architecture view.  
* 💡 Save **manual versions** at key milestones (e.g., approved diagrams).  
* 🔗 Attach diagrams to relevant documents (e.g., policies, procedures).  
---

### **🎯 Visual Checklist**  
* [x] New diagram created in folder  
* [ ] Manual version saved for milestone  
* [ ] Diagram linked to existing document