581 stars · MIT · v0.86.0 (2026-08-28) · Track this in Scout
Builds an API documentation site from one or more OpenAPI schemas, with an in-browser request playground, and lets hand-written MDX guides live beside the generated reference.
▶Repo detailsthe review · specs · pros & cons · install
What it is
Zudoku is a documentation site builder in JavaScript. It reads one or more OpenAPI files, which is the standard machine-readable description of a web service, and produces a full reference site with a try-it panel. You add hand-written pages in MDX, which is Markdown with the ability to drop in interactive pieces.What it is good for. Anybody shipping a web service for other people to use. The reference half writes itself and stays correct, which is where hand-written documentation always fails. Guides and tutorials, which cannot be generated, live in the same site beside it. It can also sit behind a login, so private documentation is possible. For you: Grasppy is built with FastAPI, and FastAPI produces an OpenAPI description already, without you doing anything. That means most of a proper documentation site is one command away. Scalar (Ed. 11 #7) is the other answer to the same question; the difference is that Zudoku also holds your written guides.
- The reference is generated, so it cannot drift away from what the service actually does.
- Written guides and generated reference live in one site with one search box.
- The output is a plain static site, so hosting it costs nothing.
- It is version 0.86.0, before 1.0. Settings and structure can still change between minor versions.
- 581 stars, and it is made by one company, Zuplo, whose main business is an API gateway. The licence is MIT and releases are frequent, but the direction follows their commercial interest.
- It is a JavaScript toolchain, so Node.js, npm and a build step are unavoidable. If your product is not a web service, a general documentation builder suits you better.
scalar/scalarThe same generated reference with a try-it panel, but centred on being a full request client as well as documentation.
Track this in Scout- Redocly/redoc
The same OpenAPI-to-reference rendering in the familiar three-panel layout, but reference only, with no place for written guides.
Track this in Scout - fuma-nama/fumadocs
A documentation framework for React sites covering the same job, stronger on general writing and weaker on generated API reference.
Track this in Scout
npm create zudoku@latest cd my-docs npm run dev
