https://github.com/bowencool/swagger-ui

swagger.json to UI (web page)
https://github.com/bowencool/swagger-ui

swagger swagger-docs swagger-json-to-ui swagger-ui swagger2

Last synced: 11 months ago
JSON representation

swagger.json to UI (web page)

• Host: GitHub
• URL: https://github.com/bowencool/swagger-ui
• Owner: bowencool
• Created: 2019-01-14T12:22:37.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2021-05-28T13:12:07.000Z (about 5 years ago)
• Last Synced: 2025-06-14T21:07:14.164Z (about 1 year ago)
• Topics: swagger, swagger-docs, swagger-json-to-ui, swagger-ui, swagger2
• Language: Vue
• Homepage:
• Size: 1.82 MB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# swagger-ui

## Usage

### production or preview

``` bash

npm i && npm run build

docker build -t swagger-ui .

docker run -d -p 1001:80 swagger-ui # open http://localhost:1001

```

### screenshot

![screenshot](screenshot/0.png)

![screenshot](screenshot/4.png)

### custom in development

``` bash

 PROXY=https://petstore.swagger.io BASE_PATH=/v2 PORT=9001 npm run dev

```

If you are new to swagger and using nodejs, I recommend [swagger-jsdoc](https://www.npmjs.com/package/swagger-jsdoc) for convenient

## Todo

 - [ ] 配置设计

 - [x] 支持swagger 2.x

 - [ ] 支持swagger 3.x

 - [ ] 增强顶部搜索框

 - [ ] ts重构