HN Explorer

Ask HN: Node.js API Documentation

6 points by devfatigue ↗ HN
What do you use to get a swagger.json or similar for api documentation?

In the dotnet world there is swashbuckle. Is there a node equivalent or better?

4 comments

[ 4.0 ms ] story [ 27.0 ms ] thread
Raed667
I have been using tsoa to generate API documentation from TypeScript types. https://github.com/lukeautry/tsoa

Example project: https://github.com/RaedsLab/demo-project/blob/master/backend...

bacbilla
Second this, it's a great piece of work.
vmarchaud
We used tsoa where i work but had issues with complex types [0] so one of our dev rewrote a simpler implementation [1] that use ts-morph [2] under the hood.

Not exactly related but we had issues with the official openapi generated so he also wrote a package to codegen typescript client from an openapi file [3]

[0]: https://github.com/lukeautry/tsoa/pulls?q=is%3Apr+sort%3Aupd...

[1]: https://github.com/Eywek/typoa

[2]: https://github.com/dsherret/ts-morph

[3]: https://github.com/Eywek/oatyp