Skip to content

Visually design your AsyncAPI files and event-driven architecture.

License

Notifications You must be signed in to change notification settings

codingtenshi/studio

 
 

Repository files navigation

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

Studio is also available as a Docker Desktop Extension. For more information, check the related repository.

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
Maciej Urbańczyk

🚧 💻 📖 🐛 🤔 👀 🎨 ⚠️ 🚇 🧑‍🏫
Fran Méndez
Fran Méndez

🚧 💻 📖 🐛 🤔 👀 🎨 ⚠️ 🚇 🧑‍🏫
David Boyne
David Boyne

🚧 💻 📖 🐛 🤔 👀 🎨 ⚠️ 🧑‍🏫
Missy Turco
Missy Turco

🚧 💻 🤔 👀 🎨 🧑‍🏫
Florian Greinacher
Florian Greinacher

💻 🚇 🐛 📖
Ritik Rawal
Ritik Rawal

💻
Samriddhi
Samriddhi

💻
Pauline P. Narvas
Pauline P. Narvas

💻 🚇 📖
Jonas Lagoni
Jonas Lagoni

🤔 💬 👀
Sergio Moya
Sergio Moya

🤔 💬
David Pereira
David Pereira

🤔 💬
Nawed Ali
Nawed Ali

💻 🐛
Viacheslav Turovskyi
Viacheslav Turovskyi

💻

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

About

Visually design your AsyncAPI files and event-driven architecture.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 94.1%
  • TypeScript 5.7%
  • Other 0.2%