swagger-ui-gen
Input your swagger.json
and generate a static swagger UI. It's the official Swagger UI and you can host it anywhere you like.
Usage
$ npm install -g swagger-gen
$ swagger-gen swagger.json
By default the site will be generated in ./swagger-dist
but you can specify a different destination with -d
swagger-gen -d my-swagger-site swagger.json
You can also pipe the swagger JSON into swagger-gen
if you wish e.g.
curl http://petstore.swagger.io/v2/swagger.json | swagger-gen
Lastly, you can choose to hide the 'Try it out' buttons provided by the Swagger UI using --no-try-out
swagger-gen swagger.json --no-try-out
Demo
How does it work?
This module bundles up the swagger-ui-dist and makes a few tweaks in the index.html
file to include the data from your swagger.json
file.
Acknowledgements
This project is kindly sponsored by nearForm
License
MIT