@asyncapi/studio
v1.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.
0/weekUpdated 1 weeks agoApache-2.0Unpacked: 186.3 MB
Published by The AsyncAPI maintainers
npm install @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.
---
:loudspeaker: 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
- Using it via Docker
- Development
* Spin up Gitpod
- Contribution
- Contributors โจ
Requirements
- NodeJS >= 14
Using it locally
Run:
``bash`
pnpm install
pnpm start
and then go to http://localhost:3000.
Using it via Docker
Run:
`bash`
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.nginx
Please refer to the Nginx documentation to learn how to e.g. pass a custom 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:
`bash`
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 pnpm install
2. Write code and tests.
3. Make sure all tests pass
$3
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):
This project follows the all-contributors specification. Contributions of any kind welcome!