tsoa

This is the best project I’ve found to that for that - https://github.com/lukeautry/tsoa. Uses decorators mainly. If there are other such projects, please share.

I honestly recommend TSOA (https://github.com/lukeautry/tsoa) For me it provides enough structure without being a super opinionated framework. It handles route and doc generation based off your models and controllers, but everything else is up to you, which is perfect for me.

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

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...

We use TSOA[1] for that, it can build OpenApi specification from your ts interface. So its could be used for documentation and tsoa can validate but other tools can validate too [1] https://github.com/lukeautry/tsoa

This is also exactly how I build Express APIs. One thing I'd add: when building an API, use Swagger (or something similar, but Swagger/OpenAPI have basically won, just do it). It makes API clients way, way easier to wrangle and removes a lot of the surprise from your application development. I sometimes forget that not everyone using React or Vue uses Swagger-based APIs that really do just kinda work, but they're a large part of why, for me, writing a fully-featured frontend is way better than entering Rails template hell or whatever. It's really, really easy: just a bit of state in the React component, kick off a fetch during componentWillMount, and drop a spinner that remains 'til you get an error or your data. If you're using TypeScript (and you should be), you'll have some pretty happy autocomplete based on the contents of your state