Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/darosh/oax

OpenApi Specification Explorer
https://github.com/darosh/oax

Last synced: 4 months ago
JSON representation

OpenApi Specification Explorer

Host: GitHub
URL: https://github.com/darosh/oax
Owner: darosh
License: mit
Created: 2017-07-13T15:35:22.000Z (almost 7 years ago)
Default Branch: master
Last Pushed: 2022-12-30T16:35:11.000Z (over 1 year ago)
Last Synced: 2024-02-22T14:31:32.889Z (4 months ago)
Language: Vue
Homepage: https://darosh.github.io/oax/
Size: 37 MB
Stars: 259
Watchers: 16
Forks: 44
Open Issues: 56
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome-stars - oax
my-awesome-stars - darosh/oax - OpenApi Specification Explorer (Vue)

README

        # OAX — OpenAPI Specification Explorer [![demo: online](https://img.shields.io/badge/demo-online-brightgreen.svg?style=flat-square)](https://darosh.github.io/oax/)

## Resources

* Online [demo](https://darosh.github.io/oax/)

* Automated [screenshots](./doc/screenshots/README.md)

* [Research](./doc/RESEARCH.md) notes

## Status

Feature|Status|Note

:---|:---|:---

OpenApi directory browser|![100%](https://placehold.it/12/44cc11?text=+) 100%| 500+ API specifications powered by [APIs.guru](https://apis.guru/openapi-directory/)

SDK code generator|![100%](https://placehold.it/12/44cc11?text=+) 100%| powered by [swagger-codegen](https://github.com/swagger-api/swagger-codegen) via [generator.swagger.io](https://generator.swagger.io/) 

Markdown & syntax highlight|![100%](https://placehold.it/12/44cc11?text=+) 100%| using [showdown](https://github.com/showdownjs/showdown) & [highlight.js](https://highlightjs.org/) with 40 language highlighters 

Using web worker|![100%](https://placehold.it/12/44cc11?text=+) 100%| for non-blocked user interface

Light & dark theme|![100%](https://placehold.it/12/44cc11?text=+) 100%| thanks to [Vuetify](https://vuetifyjs.com/)

Built-in HTTP reference|![100%](https://placehold.it/12/44cc11?text=+) 100%| by [know-your-http-well](https://github.com/for-GET/know-your-http-well) 

Responsive & mobile|![100%](https://placehold.it/12/44cc11?text=+) 100%|  

Offline & progressive|![80%](https://placehold.it/12/44cc11?text=+) 80%| 

Keyboard shortcuts & navigation|![80%](https://placehold.it/12/44cc11?text=+) 80%|

View & layout options|![80%](https://placehold.it/12/44cc11?text=+) 80%| 

Schema & examples|![75%](https://placehold.it/12/dfb317?text=+) 75%| 

Try out API|![50%](https://placehold.it/12/dfb317?text=+) 50%| 

CORS proxy|![50%](https://placehold.it/12/dfb317?text=+) 50%| 

Edit specification|![50%](https://placehold.it/12/dfb317?text=+) 50%| using [CodeMirror](http://codemirror.net/) editor and web worker

TODO:
hinting
scroll to operation
markdown
YAML

Search|![10%](https://placehold.it/12/dfb317?text=+) 10%| 

Security definitions|![25%](https://placehold.it/12/e05d44?text=+) 25%| 

Customization & configuration|![10%](https://placehold.it/12/e05d44?text=+) 10%| 

SEO & SSR|![0%](https://placehold.it/12/e05d44?text=+) 0%| 

Local storage for user settings|![0%](https://placehold.it/12/e05d44?text=+) 0%| 

Cross-browser compatibility|![0%](https://placehold.it/12/e05d44?text=+) 0%| not tested yet (Chrome browser should work) 

Print style & PDF export|![0%](https://placehold.it/12/e05d44?text=+) 0%|

OpenAPI version 3.0|![0%](https://placehold.it/12/e05d44?text=+) 0%|

## Build Setup

### Install

``` bash

npm install # or yarn (yarn required for NUXT build)

```

### Webpack

``` bash

npm run webpack:dev # serve with hot reload at localhost:8080

npm run webpack:build # build for production with minification 

npm run webpack:report # build for production and view the bundle analyzer report

```

For detailed explanation on how things work, checkout the [guide](http://vuejs-templates.github.io/webpack/) and [docs for vue-loader](http://vuejs.github.io/vue-loader).