https://github.com/event-catalog/eventcatalog
The architecture catalog for distributed systems. Document events, services, domains & flows with AI-powered discovery.
https://github.com/event-catalog/eventcatalog
ai architecture asyncapi ddd distributed-systems documentation domain-driven-design event-catalog event-driven-architecture microservices
Last synced: 15 days ago
JSON representation
The architecture catalog for distributed systems. Document events, services, domains & flows with AI-powered discovery.
- Host: GitHub
- URL: https://github.com/event-catalog/eventcatalog
- Owner: event-catalog
- Created: 2021-11-18T20:59:21.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2026-02-27T16:42:43.000Z (about 2 months ago)
- Last Synced: 2026-02-27T16:43:16.789Z (about 2 months ago)
- Topics: ai, architecture, asyncapi, ddd, distributed-systems, documentation, domain-driven-design, event-catalog, event-driven-architecture, microservices
- Language: TypeScript
- Homepage: https://eventcatalog.dev
- Size: 51.1 MB
- Stars: 2,569
- Watchers: 22
- Forks: 238
- Open Issues: 177
-
Metadata Files:
- Readme: README.md
- Funding: .github/funding.yml
- Codeowners: .github/CODEOWNERS
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-github-repos - event-catalog/eventcatalog - The architecture catalog for distributed systems. Document events, services, domains & flows with AI-powered discovery. (TypeScript)
- awesome - event-catalog/eventcatalog - An open source documentation tool to bring discoverability to your architecture (DDD, micro-services, event-driven architectures) (<a name="TypeScript"></a>TypeScript)
- awesome-ccamel - event-catalog/eventcatalog - The architecture catalog for distributed systems. Document events, services, domains & flows with AI-powered discovery. (TypeScript)
README
## The architecture catalog for distributed systems
Discover your domains, services, events, and schemas — with AI-powered discovery, interactive visualizations, and 15+ generators for Kafka, EventBridge, RabbitMQ, and more.
[](https://github.com/event-catalog/eventcatalog/actions/workflows/verify-build.yml)
[](https://github.com/event-catalog/eventcatalog/blob/main/LICENSE)
[](https://badge.fury.io/js/@eventcatalog/core)
[](#contributors-)
**31,000+ catalogs created**
[Documentation](https://www.eventcatalog.dev/docs) | [Live Demo](https://demo.eventcatalog.dev) | [Discord](https://discord.gg/3rjaZMmrAm)
## Get started in seconds
```bash
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](https://www.eventcatalog.dev/docs/development/getting-started/installation) guide.
---
## Core Features
### Visualise your architecture
Interactive node graphs that map your entire system — services, events, commands, queries, domains, and how they connect.
### 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 explore your catalog.
### Schema explorer
Quickly find any schema across your catalog — OpenAPI, AsyncAPI, Protobuf, JSON Schema, Avro, and more. All in one searchable place.
### Schema fields
Filter and find any property on any field across your entire catalog. See how fields are used across services and messages.
### Bring your own docs
Attach architecture decision records, runbooks, and any custom documentation to your domains, services, and teams. Version them alongside your architecture.
### 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.
### 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:
| | | |
|---|---|---|
| [**E-Commerce**](https://demo.eventcatalog.dev/) | [**Finance**](https://eventcatalog-examples-finance.vercel.app/) | [**Healthcare**](https://eventcatalog-examples-healthcare.vercel.app/) |
| [**SaaS**](https://eventcatalog-examples-saas.vercel.app/) | | |
---
## Packages
| Package | Description |
|---------|-------------|
| [@eventcatalog/core](./packages/core) | Main catalog application (Astro + React) |
| [@eventcatalog/sdk](./packages/sdk) | Node.js SDK for programmatic catalog management |
| [@eventcatalog/create-eventcatalog](./packages/create-eventcatalog) | CLI scaffolding tool |
| [@eventcatalog/visualiser](./packages/visualiser) | Standalone React visualiser component |
| [@eventcatalog/dsl-playground](./packages/playground) | Browser-based DSL playground |
---
## Documentation
Visit the [official docs](https://www.eventcatalog.dev/docs/development/getting-started) to learn more.
---
## Support
Need help? Join the [EventCatalog Discord](https://discord.gg/3rjaZMmrAm).
---
## Contributing
We welcome contributions! See the [contributing guidelines](https://eventcatalog.dev/docs/contributing/overview) to get started.
---
## Contributors ✨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
David Boyne
💻 🖋 🎨 💡 🤔 📖
Benjamin Otto
💻 🤔 📖 🐛
Tiago Oliveira
📖 🐛
Jay McGuinness
📖
David Khourshid
📖
thim81
🤔 🐛 💻
Muthu
🐛
Dan Tavelli
📖
steppi91
📖
Donald Pipowitch
🐛 💻
Ken
📖
Rodolfo Toro
💻
Drew Marsh
💻
Dec Kolakowski
💻 📖
Yevhenii Dytyniuk
💻
lcsbltm
💻
Matt Martz
💻
Michel Grootjans
💻
Arturo Abruzzini
💻
Ad L'Ecluse
💻
Rafael Renan Pacheco
💻 📖
Luis Diego
💻
Daniel Ruf
📖
Fredrik Johansson
💻
Naresh Kumar Reddy Gaddam
💻
Andre Deutmeyer
💻
Pebbz
💻
Alexander Holbreich
📖
José Delgado
💻
jlee-spt
💻
Kim Rejström
💻
Christophe Gabard
💻
Carlo Bertini
💻
David Regla
💻
Marcio Vinicius
💻
Daniel Andres Castillo Ardila
💻
Baerten Dennis
💻
Ryan Cormack
💻
Nathan Birrell
💻
Jack Tomlinson
💻
Carlos Rodrigues
💻
omid eidivandi
💻
Simone Fumagalli
📖
d-o-h
💻
Cristian Pallarés
💻
Sebastian Rendon
💻
Craig Roberts
💻
Ivan Milosavljevic
📖
Martin Meredith
💻
Ruud Welling
💻
Kevin Pouget
💻
Vitalii Balash
💻
Arnaud Babilone
💻
Alexander Horner
💻
simonwfarrow
💻
Augusto Romero Arango
💻
cc-stjm
💻
Lucian Lature
🐛 💻
Vilas Chauvhan
💻
Eric Hoffman
🐛
wimhaesen-kine
💻
Ondrej Musil
🐛 🤔
Anatoly Bolshakov
💻
reisingerf
📖
Jonathan Barette
💻
mumundum
💻
Piotr Rybarczyk
🐛
ZakaryaCH
🐛
Jasper Boeijenga
💻
Tom Kirkpatrick
💻
Machul
🐛
ugostack
💻
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
---
**[Website](https://eventcatalog.dev)** | **[Docs](https://www.eventcatalog.dev/docs)** | **[Discord](https://discord.gg/3rjaZMmrAm)** | **[Twitter](https://twitter.com/eventcatalog)**
Made with ❤️ by the EventCatalog community
---
## License
MIT.