Openapi-browser NPM

openapi-browser

The OpenAPI Browser is a wrapper package built around the Swagger UI tool which allows you to edit Open API specifications in YAML inside your browser and preview its documentations in real time.

The OpenAPI Specification is a community-driven open specification within the OpenAPI Initiative, a Linux Foundation Collaborative Project.

OpenAPI Browser is built with swagger-ui-dist which is a dependency-free module that includes everything you need to serve Swagger UI in a project.

Features

Hot reload.
Runs as a stand-alone web application in a port of your choice.
View your OpenAPI yaml/json file describing your project API.

Getting Started

In a typical workflow of building an API based on the Open API specifications, you would design and model your API, write the implementation code, test it and maintain it.

Install

In a new or existing folder containing your project:

npm install openapi-browser

Usage

By default openapi-browser will run in port 30303 and will attempt to find an OpenAPI yaml file in the default path src/api/v1/api.yaml

You can add an entry to the "scripts" section in package.json:

"scripts": {
  "api:edit": "openapi-browser --file ./src/api/v1/api.yaml --port 10021"
}

You can also run it from the command line using npx

npx openapi-browser --file ./src/api/v1/api.yaml --port 10021

Or in JavaScript by importing the module

const openApiBrowser = require('openapi-browser');

const options = {
  file: './src/api/v1/api.yaml', // specify path as string or fully resolved path
  port: 10021, // specify port or omit for random port usage
  silent: false, // invoque browser or run silently
};

openApiBrowser.edit(options);