Skip to main content

Dokcli An OpenAPI Documentation Tool

·1 min
Shoaib Shaikh
Author
Shoaib Shaikh
Web Developer, Flutter Developer, Full Stack DevOps

Dokcli is an OpenAPI Documentation tool, consisting of ⚡ -
#

  • built-in Rapidoc web component
  • support Swagger & OpenAPI Spec
  • Convenient way of hosting Api Documentation in 1 file

For documentation and examples, please visit https://github.com/Shoaibashk/dokcli

🚧 Please keep in mind that Dokcli is still under active development ⚗️ and therefore full backward compatibility is not guaranteed before reaching v1.0.0

Overview ✨
#

Dokcli could be downloaded directly as a standalone app for API Documentation using Swagger & OpenAPI spec file.

Quickstart 🚀
#

  • Download the dokcli from release.
  • Store it in a folder doc/ as a executable.
  • Now, open the terminal, cd to the newly created folder location and simply type:
    • ./dokcli serve
  • You can provide server port and openAPI spec url.
    • ./dokcli serve -p 2323 -u https://petstore.swagger.io/v2/swagger.json

Customization 💅 (coming soon)
#

❗ Dokcli uses rapidoc web component under the hood 🌺. Its still under active development.

Dokcli can be Customized using config file config.yaml.

You can look at the help section in ./dokcli help.

Support 🤗
#

The supported build targets at the moment are:

darwin  arm64
darwin  amd64
linux   arm64
linux   386
linux   amd64
windows 386
windows amd64
windows arm64