edwinbernadus / dokunext

DokuNEXT is simple documentation generator for Postman (currently only supports Postman v2.1 API) that can simpli you use for viewing API Documentation, offline or deployed on hosting

Home Page:https://dokunext.vercel.app

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

dokuNEXT

DokuNEXT is simple documentation generator for Postman (currently only supports Postman v2.1 API) that can simpli you use for viewing API Documentation, offline or deployed on hosting.

You can see the demo here -> https://dokunext.vercel.app/. Just open up and fill the authorization token with dokunext and you are ready to go

Getting Started

  1. To start you have to clone this repo.

    git clone https://github.com/azvyae/dokunext
  2. Update your .gitignore file to allow json/postman/collections/* and json/postman/environments/* folder being updated to for git.

  3. Export Postman v2.1 collection json file and put it to json/postman/collections folder. You may also want to export environments and put it to json/postman/environments/* folder.

  4. Add .env file to root of your project providing SECRET_TOKEN key and its value. You can also provide SECRET_TOKEN environment variable to your hosting.

  5. Build, and voila!

    npm run build

Features

  • API Documentation Generator with markdown support, definition files supported are:
    • Postman v2.1
  • Organized folder table of contents and anchor links to each API requests
  • Support multiple collections and environments
  • Has simple authorization by providing simple token
  • Examples! It can show multiple examples and its returned response code, code example supported are:
    • cURL
  • Copy paste code easy
  • Responsive UI

Learn More

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

Contributing

Feel free to open issues and pull requests.

Future plan:

  • Organize better
  • Allow support on OpenAPI file definitions
  • Improve UI

About

DokuNEXT is simple documentation generator for Postman (currently only supports Postman v2.1 API) that can simpli you use for viewing API Documentation, offline or deployed on hosting

https://dokunext.vercel.app

License:Other


Languages

Language:TypeScript 97.0%Language:JavaScript 1.9%Language:CSS 1.1%