spec-renderer and swagger-ui-web-component don't allow changing the theme

[vprakash-seatgeek]

We've been trying to put a custom theme on top of the open-source dev portal. To render an OpenAPI spec, the portal relies on spec-renderer which in turn uses swagger-ui-web-component. However, swagger-ui-web-component hardcodes SwaggerUIKongTheme and KongLayout when providing a layout to SwaggerUI.

As it stands today, to customize the spec rendering in the open source portal you have two options:

• Write your own spec rendering component from scratch, instantiate SwaggerUI directly, and provide a theme.
• Fork this repo to change the dependencies in spec-renderer and swagger-ui-web-component.

Neither of these is ideal for us. Would it be possible to make the theme more configurable in this flow?

[nateslo]

Hi @vprakash-seatgeek. Currently, the best approach is to fork spec-renderer and swagger-ui-web-component. I understand this is not an ideal development experience. We are still looking into a better solution and appreciate your feedback.