event-catalog/eventcatalog

Documentation tool built for software architecture. Document your domains, services, events and schemas — for your teams and your AI agents.

TypeScript

2,925

1,779 commits

updated Oct 9, 2026

See the code

README

EventCatalog overview

The open source documentation tool for software architectures.

A documentation tool designed for software architecture not generic pages.

Document systems, domains, services, messages and schemas. Document your architecture they way you build it.

Customize your documentation to fit your workflow. Automate it, customize it, visualize it.

main License npm version All Contributors

40,000+ catalogs created


Architecture visualiser

Documentation | Live Demo | Discord


Get started in seconds

npx @eventcatalog/create-eventcatalog@latest my-catalog

That's it. Open http://localhost:3000 and start documenting your architecture.

Looking for a guided walkthrough? Check out the Getting Started guide.


Core Features

Document your architecture

Document domains, services and messages across your architecture.

EventCatalog overview

AI-powered discovery

Ask questions about your architecture and business in natural language. The built-in AI chat and MCP server let you and your tools query your catalog.

AI-powered discovery

Schema explorer

Quickly find any schema across your catalog — OpenAPI, AsyncAPI, Protobuf, JSON Schema, Avro, and more. All in one searchable place.

Schema explorer

Schema fields

Filter and find any property on any field across your entire catalog. See how fields are used across services and messages.

Schema fields explorer

Bring your own docs

Attach architecture decision records, runbooks, and any custom documentation to your domains, services, and teams. Version them alongside your architecture.

Bring your own docs

Document business flows

Tell the end-to-end story of your business workflows. Reference the services and messages you already have to build a higher-level picture of how everything fits together.

Business flow documentation

And much more...

  • Version your resources — Full semantic versioning for events, commands, services, and more
  • 15+ generators — Auto-generate from AsyncAPI, OpenAPI, Kafka, Confluent, AWS EventBridge, and more
  • Customizable — Themes, custom MDX components, and configurable layouts
  • Enterprise ready — OAuth2, RBAC, schema governance, breaking change detection

Demos

See EventCatalog powering real-world architectures:


Packages

PackageDescription
@eventcatalog/coreMain catalog application (Astro + React)
@eventcatalog/sdkNode.js SDK for programmatic catalog management
@eventcatalog/create-eventcatalogCLI scaffolding tool
@eventcatalog/visualiserStandalone React visualiser component

Documentation

Visit the official docs to learn more.


Support

Need help? Join the EventCatalog Discord.


Contributing

We welcome contributions! See the contributing guidelines to get started.


Contributors ✨

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind welcome!


Website | Docs | Discord | Twitter

Made with ❤️ by the EventCatalog community


License

EventCatalog uses a mixed-license model. Most of the repository is licensed under MIT; paid feature directories identified in the root LICENSE use the EventCatalog Commercial License.

ai
architecture
asyncapi
ddd
distributed-systems
documentation
domain-driven-design
event-catalog
event-driven-architecture
microservices

event-catalog/eventcatalog

Documentation tool built for software architecture. Document your domains, services, events and schemas — for your teams and your AI agents.

TypeScript

2,925

1,779 commits

updated Oct 9, 2026

See the code

README

EventCatalog overview

The open source documentation tool for software architectures.

A documentation tool designed for software architecture not generic pages.

Document systems, domains, services, messages and schemas. Document your architecture they way you build it.

Customize your documentation to fit your workflow. Automate it, customize it, visualize it.

main License npm version All Contributors

40,000+ catalogs created


Architecture visualiser

Documentation | Live Demo | Discord


Get started in seconds

npx @eventcatalog/create-eventcatalog@latest my-catalog

That's it. Open http://localhost:3000 and start documenting your architecture.

Looking for a guided walkthrough? Check out the Getting Started guide.


Core Features

Document your architecture

Document domains, services and messages across your architecture.

EventCatalog overview

AI-powered discovery

Ask questions about your architecture and business in natural language. The built-in AI chat and MCP server let you and your tools query your catalog.

AI-powered discovery

Schema explorer

Quickly find any schema across your catalog — OpenAPI, AsyncAPI, Protobuf, JSON Schema, Avro, and more. All in one searchable place.

Schema explorer

Schema fields

Filter and find any property on any field across your entire catalog. See how fields are used across services and messages.

Schema fields explorer

Bring your own docs

Attach architecture decision records, runbooks, and any custom documentation to your domains, services, and teams. Version them alongside your architecture.

Bring your own docs

Document business flows

Tell the end-to-end story of your business workflows. Reference the services and messages you already have to build a higher-level picture of how everything fits together.

Business flow documentation

And much more...

  • Version your resources — Full semantic versioning for events, commands, services, and more
  • 15+ generators — Auto-generate from AsyncAPI, OpenAPI, Kafka, Confluent, AWS EventBridge, and more
  • Customizable — Themes, custom MDX components, and configurable layouts
  • Enterprise ready — OAuth2, RBAC, schema governance, breaking change detection

Demos

See EventCatalog powering real-world architectures:


Packages

PackageDescription
@eventcatalog/coreMain catalog application (Astro + React)
@eventcatalog/sdkNode.js SDK for programmatic catalog management
@eventcatalog/create-eventcatalogCLI scaffolding tool
@eventcatalog/visualiserStandalone React visualiser component

Documentation

Visit the official docs to learn more.


Support

Need help? Join the EventCatalog Discord.


Contributing

We welcome contributions! See the contributing guidelines to get started.


Contributors ✨

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind welcome!


Website | Docs | Discord | Twitter

Made with ❤️ by the EventCatalog community


License

EventCatalog uses a mixed-license model. Most of the repository is licensed under MIT; paid feature directories identified in the root LICENSE use the EventCatalog Commercial License.

ai
architecture
asyncapi
ddd
distributed-systems
documentation
domain-driven-design
event-catalog
event-driven-architecture
microservices

Significant stargazers

(top 24 of 25)

Matteo Collina

11,397 followers · starred May 2024

Andreas Möller

660 followers · starred Mar 2026

Gram

365 followers · starred Dec 2022

李晓双 Li Xiao Shuang

171 followers · starred Jul 2022