Skip to main content

Version Control & Audits

EventCatalog Studio is built to fit directly into your existing Git workflows. You can export your diagrams and store them in Git.

By storing your diagrams in Git, you gain full version control, traceability, and auditability — the same benefits you already enjoy with your source code.

Why Store Diagrams in Git?​

  • Version Control for Architecture - Every diagram change is tracked with a commit history. See exactly what changed, when, and by whom.
  • Review & Approval Workflows - Use pull requests to review and approve architectural changes before they become part of your system.
  • Rollback Anytime - Revert to a previous version of your design if something goes wrong or if a decision needs to be revisited.
  • Compliance & Auditability - Meet internal and external audit requirements by keeping a permanent, reviewable record of architecture decisions.
  1. Export your diagrams from Studio as files.
  2. Store them in Git — ideally alongside the service they represent.
  3. Commit and push changes whenever diagrams are updated.
  4. Open pull requests for reviews, just like you do with code.
  5. Merge once approved — ensuring decisions are transparent and tracked forever.