node package manager
Easy sharing. Manage teams and permissions with one click. Create a free org ยป


Swagger UI Watcher

Swagger UI Watcher detects changes in your local Swagger files and reload Swagger UI in your browser to give you fluid workflow. It is primarily developed to work with multiple Swagger files using $ref.


  • Using online Swagger Editor is annoying. You have to copy and paste your Swagger files back and forth.
  • Relative and local system $ref do not work with online Swagger Editor v3
  • Manually creating bundle from multiple Swagger files after each update is impractical and tiresome.
  • Using my editor/ide of choice is awesome.


npm install swagger-ui-watcher -g


swagger-ui-watcher ./main-swagger-file.json ./folder-with-swagger-files

You can also save a bundle with --bundle option on file change event.

swagger-ui-watcher ./swagger-main-file.json ./folder-with-swagger-files --bundle=./bundled.json

Click the image to see it in action

Alt text