apinf / openapi-designer

Design interface for creating Open API (Swagger) specification files
https://openapi.design
MIT License
68 stars 18 forks source link
api-design api-documentation open-api open-api-specification swagger swagger-spec swagger-specification

OpenAPI designer

Design interface for creating OpenAPI (Swagger) specification files. Live demo

Setup

  1. Have a Node.js install that's not way too old (v4+ should work for everything).
  2. Install Aurelia CLI (npm install -g aurelia-cli)
  3. Clone this repo (git clone https://github.com/apinf/open-api-designer.git)
  4. Install dependencies (npm install)
  5. Build the code (au build) and open index.html OR run the webserver integrated in Aurelia using au run and open the URL that is printed after building (usually http://localhost:9000)

Docker

  1. Follow setup instructions step #2
  2. Run docker build -t openapi-designer . (Run with --build-arg env=prod to compile the production version.)
  3. Run docker run -p <port>:80 openapi-designer replacing <port> with the port you want the app to be accessible at.
  4. The designer should now be accessible at http://localhost:<port>

Development Status

Throughput Graph

Resources