Skip to content
AsyncAPI React Component
TypeScript CSS Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github
docs
library
playground
.all-contributorsrc
.gitattributes
.gitignore
.markdownlintrc
.prettierignore
.prettierrc
CODEOWNERS
CONTRIBUTING.md
LICENSE
README.md
lerna.json
package-lock.json
package.json
tsconfig.base.json
tslint.json

README.md

AsyncAPI logo
React Component

A official React component for AsyncAPI 2.0 specification


All Contributors

Overview

A official React component for AsyncAPI 2.0 specification. It allows you to render the documentation of your asynchronous API provided in the AsyncAPI specification format and validate this specification. You can fully restyle the component using your own styles.

CAUTION: This package only supports AsyncAPI 2.0 specification. If you use 1.x, we recommend that you upgrade to the latest AsyncAPI version using the Node.js or Go converters.

Playground

This repository comes in with a Playground application. Test it to see the component in action and play with it before you use it in your application.

You can also run the Playground application locally by following this instruction from the development guide.

Prerequisites

  • react (version 16.8.0 or higher)

Usage

Run this command to install the component in your project:

npm install --save @kyma-project/asyncapi-react

Check out this simple sandbox application that uses the asyncapi-react component:

Edit 5vz8l9zlmn

Props

The list of props for the AsyncAPI React component includes:

  • schema: string | AsyncApiInterface | FetchingSchemaInterface

    The schema property is required and contains AsyncAPI specification. Use the string type, the AsyncApiInterface type, or the FetchingSchemaInterface object to fetch the schema from an external resource. For more information on what it contains and what it should look like, read AsyncAPI Specification.

  • config?: Partial<ConfigInterface>

    The config property is optional and contains configuration for the AsyncAPI component. For more information on the available configuration options, read the Configuration Modification document. This property is concatenated with the default configuration.

    NOTE: The Partial<T> type means that every field in the T type is optional.

Styles

To use default styles based on SAP Fundamentals, import them as follows:

import "@kyma-project/asyncapi-react/lib/styles/fiori.css";

For information on how to change styles, read the Style Modification document.

Development

For information on how to set up a development environment, write and run tests, follow the naming and architecture convention defined for the project in the Development Guide.

Releasing

For information on how to release a new version of the library or the playground application, or details on creating a changelog file, read the Releasing document.

Contribution

If you have a feature request, add it as an issue or propose changes in a pull request (PR). If you create a feature request, use the dedicated Feature request issue template. When you create a PR, follow the contributing rules described in the CONTRIBUTING.md document.

If you have a bug to report, reproduce it in an online code editor. For example, use CodeSandbox. Attach the link to the reproduced bug to your issue. Log the bug using the Bug report template.

Missing features

See the list of features that are still missing in the component:

If you want to help us develop them, feel free to contribute.

Credits

Contributors

Thanks goes to these wonderful people (emoji key):

Maciej Urbańczyk
Maciej Urbańczyk

💻 📖 🤔 🚧 👀 ⚠️
Karolina Zydek
Karolina Zydek

📖 👀 🚧
Agata
Agata

💻 🚧
Lukasz Gornicki
Lukasz Gornicki

📖 💡 🤔
Mateusz Puczyński
Mateusz Puczyński

💻 📖 🤔 🚧 👀 ⚠️

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

You can’t perform that action at this time.