Provide a Swagger UI for your Servant API
"Swagger UI allows anyone — be it your development team or your end consumers — to visualize and interact with the API’s resources without having any of the implementation logic in place."
Check servant-swagger-ui-example/src/Main.hs
for an example.
- Extract
dist
directory ofswagger-ui
intoswagger-dist-<version>
. Remove the*.map
files. - update
extra-source-files
in the.cabal
- move
index.html
intoindex.html.tmpl
, do the diff, port the changes - search replace the embbeded directory (in
Servant/Swagger/UI.hs
) - test it works