Show HN: Itdoc – Generate OpenAPI docs from your test code

2 penekhun 0 5/18/2025, 12:56:33 PM github.com ↗
Hey HN!

We built itdoc, generates OpenAPI documentation automatically from your integration tests (Jest or Mocha). No annotations, no manual syncing—just run your tests and get up-to-date API docs.

We were frustrated by outdated Swagger specs and repetitive documentation work. So we made a tool that turns your test cases into the single source of truth.

It outputs valid OpenAPI JSON and beautiful Redoc-style docs with zero extra effort.

In the Spring ecosystem, tools like `restdocs` already support this kind of workflow. But in the JavaScript/TypeScript world, there wasn’t a simple way to keep API docs in sync with real behavior—until now.

We're still in early stages and would love feedback from the community!

Docs: https://do-pa.github.io/itdoc

Comments (0)

No comments yet