signalk-server icon indicating copy to clipboard operation
signalk-server copied to clipboard

Alternatives to Swagger UI for rendering OpenApi docs and trying them out

Open tkurki opened this issue 1 year ago • 0 comments

I have to admit I am not too crazy about how Swagger UI looks and feels. The UI feels needlessly clumsy.

There are alternatives:

  • https://github.com/Redocly/redoc
    • Demo: https://redocly.github.io/redoc/?url=https://demo.signalk.org/skServer/openapi/security
  • https://github.com/rapi-doc/RapiDoc
    • Demo https://hisw3t.csb.app/#overview

Redoc looks to me the most polished, but doesn't have try me. RapiDoc supports theming.

Issue with comments comparing the options, but a few years old: https://github.com/rapi-doc/RapiDoc/issues/141

tkurki avatar Dec 04 '22 20:12 tkurki