tzachshabtay / RapiDoc

RapiDoc - Custom-Element for OpenAPI Spec

Home Page:https://mrin9.github.io/RapiDoc

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

MrinDoc logo

RapiDoc

Custom Eelement for Open-API spec viewing

Features

  • Supports Swagger 2.0 and OpenAPI 3.0
  • Works with any framework or with no framework
  • Allows to make API calls
  • Better Usability,
    • all Models and Examples are expanded by default, eliminates the need to click and reveal.
    • Request fields are pre-populated with sample data
    • Takes only one click to make an API call
    • Request and response can be placed side-by-side for easy comparision
  • Branding and Personalization features makes it easy to follow any style guide
    • Comes with 2 Themes (Dark and Light)
    • Replace default logo with yours
    • Typography, allows changing fonts
    • Allows changing text-color, button-color, header-color and color of other UI elements
  • Plenty of customization options
    • Add external contents at the top and bottom of the document, you may add images, link, text, forms etc
    • Allows disabling API calling feature
    • Hide the header so the user cant load any other OpenAPI Spec
    • Hide Authentication and provide your own pre-generated api-key
    • Embed it inside another HTML document
    • Use it inside another framework (react, vue, angular, lit-element)
    • Use JavaScript to change its attributes, and it will react to those changes
    • Style the element with standard css (change padding, position, border, margin )
  • Lightweight and fast (under 125 KB gzipped)
  • Load local json spec from the disk
  • Supported on Chrome, FireFox and Safari. (Not yet tested on Edge)

Documentation

Check out the usage and examples

Roadmap

  • πŸ‘ Get the bundle size even smaller (~ 125 Kb gzipped)
  • πŸ‘ Provide a console to try out the APIs
  • πŸ‘ HTTP and Token based Authentication process
  • πŸ‘ Allow replacing default logo
  • πŸ‘ Allow embeding custom HTML content
  • πŸ‘ Responsive design
  • Enable OAuth
  • Search API Functionality

About

RapiDoc - Custom-Element for OpenAPI Spec

https://mrin9.github.io/RapiDoc

License:MIT License


Languages

Language:JavaScript 96.7%Language:HTML 2.3%Language:CSS 1.0%