mauris / redocusaurus

OpenAPI for Docusaurus v2 with Redoc

Home Page:https://redocusaurus.vercel.app/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Redocusaurus

npm npm Libraries.io dependency status for latest release Typed with TypeScript Build and Deploy GitHub branch checks state This project is using Percy.io for visual regression testing.

Redoc for Docusaurus v2.

Usage

Check the documentation on the website.

Demo

See Examples

Packages

Redocusaurus

A Docusaurus Preset that combines the below 2 packages to easily add API doc(s) to your docs site.

Docusaurus Theme Redoc

A wrapper around RedocStandalone to make it match the Dcousaurus Theme with added support for Dark Mode.

Docusaurus Plugin Redoc

A content plugin that creates pages from your OpenAPI files or URLs and renders them using the Redoc component from the theme.

Website

Docs website and example project show casing the preset in action with multiple different OpenAPI specs.

Who is using Redocusaurus?

See Who is using Redocusaurus? section in docs.

Contributing

Any help is greatly appreciated, check the DEVELOPMENT.md for help on how to setup the project in your local and CONTRIBUTING.md for general info about the contribution workflow.

Motivation

To have the documentation and API reference in the same site with the same headers/footers. Read more in the blog post, OpenAPI for Docusaurus.

See this issue, https://github.com/facebook/docusaurus/issues/638, and this gist, https://gist.github.com/rohit-gohri/b1a19f37702cfe4a6c5a47933a11785b for more details and history.

License

MIT License. Copyright (c) 2022 Rohit Gohri

About

OpenAPI for Docusaurus v2 with Redoc

https://redocusaurus.vercel.app/

License:MIT License


Languages

Language:TypeScript 52.1%Language:JavaScript 26.7%Language:CSS 16.7%Language:Shell 4.5%