JSPM

  • Created
  • Published
  • Downloads 30878
  • Score
    100M100P100Q147756F
  • License Apache-2.0

One place that allows you to develop an AsyncAPI document, validate it, convert it to the latest version, preview the documentation and visualize the events flow.

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@asyncapi/studio) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    AsyncAPI Studio

    One place that allows you to develop an AsyncAPI document, validate it, convert it to the latest version, preview the documentation and visualize the events flow.

    All Contributors


    πŸ“’ ATTENTION:

    This project is still under development and has not reached version 1.0.0 yet. This means that its API/styling/features may contain breaking changes until we're able to deploy the first stable version and begin semantic versioning.


    Requirements

    Using it locally

    Run:

    npm install
    npm start

    and then go to http://localhost:3000.

    Using it via Docker

    Run:

    docker run -it -p 8000:80 asyncapi/studio

    and then go to http://localhost:8000.

    The asyncapi/studio image is based on the official nginx image. Please refer to the Nginx documentation to learn how to e.g. pass a custom nginx configuration or plug in additional volumes.

    In some hosting scenarios (e.g. Docker Compose, Kubernetes) the container might not be exposed at the root path of the host. Set the environment variable BASE_URL to let AsyncAPI Studio know from where to resolve static assets:

    docker run -it -p 8000:80 -e BASE_URL=/a/custom/path asyncapi/studio

    Development

    1. Setup project by installing dependencies npm install
    2. Write code and tests.
    3. Make sure all tests pass npm test

    Spin up Gitpod

    In order to prepare and spin up a Gitpod dev environment for our project, we configured our workspace through a .gitpod.yml file.

    To spin up a Gitpod, go to http://gitpod.io/#https://github.com/asyncapi/studio.

    Contribution

    Read CONTRIBUTING guide.

    Contributors ✨

    Thanks goes to these wonderful people (emoji key):


    Maciej UrbaΕ„czyk

    🚧 πŸ’» πŸ“– πŸ› πŸ€” πŸ‘€ 🎨 ⚠️ πŸš‡ πŸ§‘β€πŸ«

    Fran MΓ©ndez

    🚧 πŸ’» πŸ“– πŸ› πŸ€” πŸ‘€ 🎨 ⚠️ πŸš‡ πŸ§‘β€πŸ«

    David Boyne

    🚧 πŸ’» πŸ“– πŸ› πŸ€” πŸ‘€ 🎨 ⚠️ πŸ§‘β€πŸ«

    Missy Turco

    🚧 πŸ’» πŸ€” πŸ‘€ 🎨 πŸ§‘β€πŸ«

    Florian Greinacher

    πŸ’» πŸš‡ πŸ› πŸ“–

    Ritik Rawal

    πŸ’»

    Samriddhi

    πŸ’»

    Pauline P. Narvas

    πŸ’» πŸš‡ πŸ“–

    Jonas Lagoni

    πŸ€” πŸ’¬ πŸ‘€

    Sergio Moya

    πŸ€” πŸ’¬

    David Pereira

    πŸ€” πŸ’¬

    Nawed Ali

    πŸ’» πŸ›

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