Skip to main content
OpenAPI
orders-api.yaml
OrderCreated
Event
PaymentService
Service
Commerce
Domain
AsyncAPI
events.asyncapi.yaml
CreateOrder
Command
OrderSchema
Avro Schema
PaymentProcessed
Event
Fulfillment
Subdomain
GetOrderHistory
Query
orders/created
Channel
InventoryService
Service
AuthService
UserLoggedIn
CartService
ItemAdded
CartUpdated
OrderService
OrderCreated
OrderUpdated
NotificationService
PaymentService
PaymentProcessed
RefundIssued
InventoryService
StockUpdated
WarehouseService
API
Gateway
orders/new
Consumer

Make your software architecture discoverable.

EventCatalog is documentation for software architecture β€” designed to make domains, services, events, and schemas discoverable by humans and machines across distributed systems.

Self-hosted Β· Open source Β· Your data stays yours

Trusted by engineering teams worldwide β€” 28,000+ catalogs created

Why architecture becomes hard to discover.

Your architecture grows. Discoverability doesn’t.

You need to understand how services connect.

Nobody knows where to look β€” or which view reflects reality.

You need to find the owner of a service.

It takes longer than fixing the bug.

Three teams build the same integration.

Nobody knew it already existed.

A schema changes without warning.

You find out in production.

Knowledge lives across Confluence, Notion, Slack, and people's heads.

New engineers spend weeks piecing together what should be obvious.

Eventually, teams stop trusting documentation at all.

When that happens, every change feels risky β€” even small ones.

Confluence
Updated: 2 years ago
Miro Board
Owner: ???
Notion
Google Doc
v3 (or is it v5?)
#architecture
"Where's the OrderService docs?"
23 replies...
Excalidraw
Lucidchart
#platform
"Did we already build this?"
No replies yet
Wiki
Deprecated?
"Who owns this service?"
"Is this diagram current?"
"Which version is correct?"
"How does this connect?"
"Who owns this event?"
"Who is consuming this event?"
"Where is the schema?"
?
?
?

Making architecture discoverable requires a different approach.

UserCreated
Event
OrderPlaced
Event
Auth Service
Microservice
Order Service
Microservice
Payments
Domain

Making architecture discoverable in practice

EventCatalog helps teams model architectural knowledge in one place β€” making ownership, relationships, and key primitives discoverable as systems evolve.

Powered by markdown

Store documentation in your Git repository. Version controlled and developer-friendly.

Document

Your architecture visualized

EventCatalog will visualize your domains, services and messages.

Visualize

Natural language questions

Ask about your architecture in plain English. Get accurate answers instantly.

Query
API
SDK
YAML
CLI

Reduce drift between your architecture and your schemas

Pull schemas from OpenAPI, AsyncAPI, and schema registries β€” while keeping architectural context, diagrams, and language intentional and human-owned.

Generate from your specs

Use OpenAPI, AsyncAPI, and schema registries as inputs to generate and update services, events, and schemas β€” without duplicating work.

Stay in sync

When schemas change, EventCatalog can refresh the generated parts of your catalog β€” while preserving manually curated diagrams, language, and relationships.

One command

Run npm run generate locally or in CI/CD to refresh generated content from your connected systems.

SDK & API support

Extend EventCatalog to integrate with any system in your stack. If you can extract architectural data, you can model it.

Generated content stays in sync with your systems.
Architectural context stays intentional.

Connect to your stack

OpenAPIAsyncAPIGraphQLConfluentAWSAzureGCPBackstageGitHubApicurio
terminal
$npm run generate
Fetching OpenAPI specs...
Syncing AsyncAPI definitions...
Pulling schemas from registry...
Done in 2.3s. 47 resources updated.

Docs always in sync

Add to CI/CD. Never think about it again.

Context matters β€” for your team and your AI.

Empower engineers to find answers faster β€” and give AI models the context they need to understand your distributed system.

EventCatalog MCP
$
Your system has 4 domains:
1.Orders handles order lifecycle
2.Payments processes transactions
3.Inventory manages stock levels
4.Notifications sends alerts and emails
$

Ask structured questions about domains, services, events, schemas, and dependencies β€” using the same architectural model.

Privacy First

Self-hosted and secure by default β€” your architectural data never leaves your infrastructure.

MCP Server Integration

Expose your architectural model via MCP β€” enabling tools like Claude, Cursor, and VS Code to query your system structure.

Bring Your Own Models

You own your models and your data. Connect any LLM and bring your own tools to extend capabilities.

llms.txt Auto-Generation

Automatically generate llms.txt files so AI agents can discover and understand your architecture when needed.

sequenceDiagram
Mermaid
Canvas
Miro
Whiteboard
c4 Diagrams
Architecture
IcePanel
diagram.svg
Any Tool

Architecture diagrams. Versioned. Discoverable.

Bring your existing architecture diagrams into EventCatalog β€” and treat them as first-class architectural knowledge.

MermaidPlantUMLArchimateMiroIce Panelc4 DiagramsDraw.ioSVG / PNG

We don't replace your tools β€” we connect them.

Version your diagrams alongside your docs

Track how your architecture diagrams evolve over time β€” alongside services, schemas, and events.

Stored in Git. You own everything.

Your diagrams live in your repository. No vendor lock-in, no external dependencies. Perfect for regulated industries.

Searchable and discoverable

Diagrams are indexed alongside your architecture. Find flows, dependencies, and system views when you need them β€” not buried in a wiki or slide deck.

Machine-readable architecture diagrams

Because diagrams are linked to real architectural primitives, AI tools can explain flows, dependencies, and responsibilities β€” not just render images.

EventCatalog Diagrams Screenshot

EventCatalog adapts to how your teams work

Trigger catalog builds from anywhere. EventCatalog integrates into any Git-based workflow β€” across teams, repos, and pipelines β€” and can be rebuilt as often as your architecture changes.

team-orders

feat: add OrderCreated event schema

team-payments

docs: update PaymentService API

team-inventory

fix: correct StockUpdated schema

main

Merge: Build unified catalog

Deploy successful

catalog.yourcompany.com updated

3 services, 12 events, 4 schemas

Works with any CI/CD

GitHub, GitLab, Jenkins, and more

Distributed teams

When teams update their specifications or schemas in their own repositories, the catalog updates as part of their existing workflow.

Fits your pipeline

GitHub Actions, GitLab CI, Jenkins, or any CI/CD tool. EventCatalog integrates without dictating how you deploy.

Trigger on change

Rebuild documentation on schema changes, merges, releases, or on demand. You control when and how architectural changes become visible.

EventCatalog doesn't impose a workflow β€” it reflects the ones you already have.

0+
Catalogs created
0+
MCP tools
0+
Integrations
0+
Resource types

Ready to get started?

Get started in minutes. Self-hosted, open source, and your data stays yours.

No credit card required. Deploy on your own infrastructure.