Skip to content

AsyncAPI logo - Building the future of Event-Driven Architectures.

Slack Twitter LinkedIN YouTube Twitch

✨ Welcome

Welcome to the Open-Source (OSS) AsyncAPI Initiative, part of the Linux Foundation.

AsyncAPI seeks to improve the current state of Event-Driven Architectures (EDAs) and the tooling system around them. ❤️

We are a caring community 👐🏿, shaping the future of how you work with #EventDrivenArchitecture; no matter if it is Kafka or WebSocket.

Follow our public roadmap ✨ and feel free to share your suggestions 🙇🏿‍♀️🙇🏿. Or better yet, join our community 👇🏽!

🌎 Join AsyncAPI community

To get involved with our community, please make sure you are familiar with the project's Code of Conduct.

We're a community of great people who are passionate about AsyncAPI and Event-Driven Architectures. There are several ways to communicate with other people working on the AsyncAPI project:

  • Join our Slack workspace: Join our Slack workspace ☎️ and please respect our slack etiquette. If you have a question on how to use AsyncAPI, want to contribute, or simply want to say hello 👋🏾, feel free to chat with us in Slack. We're nice people. 🙂
  • Join our public meetings: AsyncAPI hosts different meetings every week. They are focused on different topic, sometimes purely technical and sometimes about community building. Pick one and join us! Learn more about our meetings.
  • Subscribe to our Newsletter: keep up to date on the project's status.
  • GitHub issues: for bugs and feature requests.
  • GitHub Pull Requests (PRs): for fixes or new features already discussed, as per the contributing guidelines.
  • The AsyncAPI YouTube Channel: it's where we record and upload our public community meetings.

📑 Getting started

Are you wondering where to look first? Then search no more! Here are some great first AsyncAPI Documentation spots to visit, so as to get acquainted with the project and tools:

👩🏽‍💻 Contribute to AsyncAPI

First of all, thanks for getting involved! ✨

There are many awesome ways to contribute to the AsyncAPI Initiative. (Code isn't the only way to help out! ❤️) The below table gives you an idea of how contributions are recognized in the project.

Emoji/Type Represents Emoji/Type Represents Emoji/Type Represents
🐛
bug
Bug reports 📝
blog
Blogposts 💻
code
Code
📖
doc
Documentation 🎨
design
Design 💡
example
Examples
🤔
ideas
Ideas & Planning 🚧
maintenance
Maintenance 💬
question
Answering Questions
👀
review
Reviewed Pull Requests 📢
talk
Talks 📹
video
Videos

To figure out a great first GitHub issue to work on, join our Slack workspace and visit the 11_contributing 🙂 channel. This channel is specifically designed for supporting all community questions on getting started as a contributor. We also host a live stream dedicated to contributors called Contributor-first. Feel invited to join one of them and for details check the list of future events.

You should also check out our contribution guide.

We can't wait to meet you! 🤗

Pinned Loading

  1. spec spec Public

    The AsyncAPI specification allows you to create machine-readable definitions of your asynchronous APIs.

    JavaScript 4.3k 271

  2. generator generator Public

    Use your AsyncAPI definition to generate literally anything. Markdown documentation, Node.js code, HTML documentation, anything!

    JavaScript 767 233

  3. asyncapi-react asyncapi-react Public

    React component for rendering documentation from your specification in real-time in the browser. It also provides a WebComponent and bundle for Angular and Vue

    TypeScript 188 125

  4. community community Public

    AsyncAPI community-related stuff.

    101 109

  5. website website Public

    AsyncAPI specification website

    TypeScript 519 657

  6. modelina modelina Public

    A library for generating typed models based on inputs such as AsyncAPI, OpenAPI, and JSON Schema documents with high customization

    TypeScript 319 184

Repositories

Showing 10 of 59 repositories
  • nodejs-ws-template Public

    Node.js WebSockets template for the AsyncAPI Generator. It showcases how from a single AsyncAPI document you can generate a server and a client at the same time.

    asyncapi/nodejs-ws-template’s past year of commit activity
    JavaScript 24 29 1 1 Updated Nov 20, 2024
  • community Public

    AsyncAPI community-related stuff.

    asyncapi/community’s past year of commit activity
  • website Public

    AsyncAPI specification website

    asyncapi/website’s past year of commit activity
    TypeScript 519 Apache-2.0 657 69 (7 issues need help) 44 Updated Nov 20, 2024
  • nodejs-template Public

    This template generates a server using your AsyncAPI document. It supports multiple different protocols, like Kafka or MQTT. It is designed in the way that generated code is a library and with it's API you can start the server, send messages or register a middleware for listening incoming messages. Runtime message validation included.

    asyncapi/nodejs-template’s past year of commit activity
    JavaScript 40 29 5 0 Updated Nov 19, 2024
  • conference-website Public

    Website for the AsyncAPI online conference

    asyncapi/conference-website’s past year of commit activity
    JavaScript 25 100 16 (2 issues need help) 11 Updated Nov 19, 2024
  • vs-asyncapi-preview Public

    VSCode AsyncAPI Preview Extension

    asyncapi/vs-asyncapi-preview’s past year of commit activity
    TypeScript 45 Apache-2.0 36 10 4 Updated Nov 19, 2024
  • modelina Public

    A library for generating typed models based on inputs such as AsyncAPI, OpenAPI, and JSON Schema documents with high customization

    asyncapi/modelina’s past year of commit activity
    TypeScript 319 Apache-2.0 184 40 (1 issue needs help) 6 Updated Nov 19, 2024
  • markdown-template Public

    Markdown template for the AsyncAPI Generator

    asyncapi/markdown-template’s past year of commit activity
    JavaScript 27 34 2 1 Updated Nov 18, 2024
  • html-template Public

    HTML template for AsyncAPI Generator. Use it to generate a static docs. It is using AsyncAPI React component under the hood.

    asyncapi/html-template’s past year of commit activity
    JavaScript 66 59 2 0 Updated Nov 18, 2024
  • cli Public

    CLI to work with your AsyncAPI files. You can validate them and in the future use a generator and even bootstrap a new file. Contributions are welcomed!

    asyncapi/cli’s past year of commit activity
    TypeScript 187 Apache-2.0 163 32 (5 issues need help) 9 Updated Nov 18, 2024