Diagrams
Most architecture diagrams go stale the moment someone changes the design. ArchRepo’s Diagrams tab avoids that by never storing a diagram at all — every view is drawn fresh from the model each time you open it. Change a relationship or record a new data use, and the next diagram reflects it.
Open it from the project’s Diagrams tab. The switcher on the right chooses which view you are looking at, and your choice is held in the page address, so a diagram is always shareable as a link.
These diagrams are read-only. You never drag boxes or draw lines here — you change what a diagram shows by changing the model behind it. If you want to draw something by hand, use a Draw.io drawing or a Mermaid diagram inside a narrative instead. The one exception is a model item’s own Data Mapping tab, where a project editor draws attribute-level mappings directly on the diagram.
The Diagram Types
| Diagram | What it answers |
|---|---|
| System Integration Context | What are the systems in this solution, which are ours and which are external, and how does data move between them? |
| User Interaction Context | Which kinds of user reach which applications? |
| Application Role | For one type of user, which applications do they have access to? |
| Application | What does one application contain, and what data does it touch? |
| UI Components | What is one application’s whole user interface made of, and which parts are shared? |
| Data Mapping | For one specification, which entities and attributes does it read, write, and transform? |
| Data Lineage | Where did this data come from, and who else uses it? |
Diagrams Elsewhere in ArchRepo
The Diagrams tab holds the project-wide views. You will also find diagrams:
- On a model item — a Data Mapping tab and a Data Lineage tab on anything that reads or writes data, plus composition and data set diagrams on the item types that carry them. The Data Mapping tab is where an item’s transformations are authored.
- Inside a Data Set — the built-in data modeller draws an entity-relationship diagram of the entities and attributes you define.
- Inside a narrative — hand-authored Mermaid, Draw.io and Figma content, for the pictures the model cannot derive for you.
Exporting
Every diagram has a download button in the top-right of the canvas, which saves the current view as an image for a slide deck or a document. Diagrams also print with the page — the toolbars and filters are hidden automatically, so the printed output is just the picture.