Gathering detailed insights and metrics for redoc
Gathering detailed insights and metrics for redoc
📘 OpenAPI/Swagger-generated API Reference Documentation
Installations
npm install redocDeveloper
Developer Guide
BETA
Module System
CommonJS, UMD
Min. Node Version
>=6.9
Typescript Support
Yes
Node Version
14.21.3
NPM Version
6.14.18
Statistics
23,670 Stars
2,599 Commits
2,309 Forks
296 Watching
13 Branches
256 Contributors
Updated on 28 Nov 2024
Bundle Size
0.95 MB
Minified
282.57 kB
Minified + Gzipped
Languages
TypeScript (97.81%)
JavaScript (1.06%)
Shell (0.46%)
HTML (0.36%)
Dockerfile (0.32%)
Total Downloads
Cumulative downloads
Total Downloads
66,164,782
Last day
-0.6%
132,009
Compared to previous day
Last week
6.9%
701,935
Compared to previous week
Last month
14.3%
2,962,762
Compared to previous month
Last year
69.3%
26,068,200
Compared to previous year
Daily Downloads
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dependencies
22
Peer Dependencies
5
Dev Dependencies
67
@cypress/webpack-preprocessor@size-limit/file@types/chai@types/dompurify@types/enzyme@types/enzyme-to-json@types/jest@types/json-pointer@types/lunr@types/mark.js@types/marked@types/node@types/prismjs@types/prop-types@types/react@types/react-dom@types/styled-components@types/tapable@types/webpack@types/webpack-env@types/yargs@typescript-eslint/eslint-plugin@typescript-eslint/parserbeautify-benchmarkconventional-changelog-clicopy-webpack-plugincore-jscss-loadercypressenzymeenzyme-to-jsonesbuild-loadereslinteslint-plugin-importeslint-plugin-reacteslint-plugin-react-hooksfork-ts-checker-webpack-pluginhtml-webpack-pluginhuskyjestjest-environment-jsdomjs-yamllicense-checkerlodash.noopmobxoutdentprettierpretty-quickrafreactreact-domrimrafshelljssize-limitstyle-loaderstyled-componentsts-jestts-nodetslibtypescriptunfetchurlwebpackwebpack-cliwebpack-dev-serverwebpack-node-externalsworkerize-loader
Versions
Generate beautiful API documentation from OpenAPI
About Redoc
Redoc is an open source tool for generating documentation from OpenAPI (formerly Swagger) definitions.
By default Redoc offers a three-panel, responsive layout:
- The left panel contains a search bar and navigation menu.
- The central panel contains the documentation.
- The right panel contains request and response examples.
Live demo
If you want to see how Redoc renders your OpenAPI definition, you can try it out online at https://redocly.github.io/redoc/.
A version of the Swagger Petstore API is displayed by default. To test it with your own OpenAPI definition, enter the URL for your definition and select TRY IT.
Redoc features
- Responsive three-panel design with menu/scrolling synchronization
- Support for OpenAPI 3.1, OpenAPI 3.0, and Swagger 2.0
- Ability to integrate your API introduction into the side menu
- High-level grouping in side menu with the
x-tagGroupsspecification extension - Simple integration with
create-react-app - Code samples support (with vendor extension)
Usage
Redoc is provided as a CLI tool (also distributed as a Docker image), HTML tag, and React component.
Generate documentation from the CLI
If you have Node installed, quickly generate documentation using npx:
1npx @redocly/cli build-docs openapi.yaml
The tool outputs by default to a file named redoc-static.html that you can open in your browser.
Redocly CLI does more than docs; check it out and add linting, bundling, and more to your API workflow.
Add an HTML element to the page
Create an HTML page, or edit an existing one, and add the following within the body tags:
1 <redoc spec-url="http://petstore.swagger.io/v2/swagger.json"></redoc> 2 <script src="https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"> </script>
Open the HTML file in your browser, and your API documentation is shown on the page.
Add your own spec-url to the <redoc> tag; this attribute can also be a local file. The JavaScript library can also be installed locally using npm and served from your own server, see the HTML deployment documentation for more details.
More usage options
Check out the deployment documentation for more options, and detailed documentation for each.
Redoc vs. Redocly API Reference
Redoc is Redocly's community-edition product. Looking for something more? We also offer hosted API reference documentation with additional features including:
- Try-it console
- Automated code samples
- Pagination
- Extra theme options
Documentation and resources
- Reference docs - we take care of the hosting
- Redoc - detailed documentation for this open source project (also in the
docs/folder) - Command-line interface to bundle your docs into a web-ready HTML file
- API linting, bundling, and much more with open source Redocly CLI
Showcase
A sample of the organizations using Redocly tools in the wild:
Pull requests to add your own API page to the list are welcome
Configuration
Redoc is highly configurable, see the configuration documentation for details.
OpenAPI specification extensions
Redoc uses the following specification extensions:
x-logo- is used to specify API logox-traitTag- useful for tags that refer to non-navigation properties like Pagination, Rate-Limits, etcx-codeSamples- specify operation code samplesx-badges- specify operation badgesx-examples- specify JSON example for requestsx-nullable- mark schema param as a nullablex-displayName- specify human-friendly names for the menu categoriesx-tagGroups- group tags by categories in the side menux-servers- ability to specify different servers for API (backported from OpenAPI 3.0)x-ignoredHeaderParameters- ability to specify header parameter names to ignorex-additionalPropertiesName- ability to supply a descriptive name for the additional property keysx-summary- for Response object, use as the response button text, with description rendered under the buttonx-extendedDiscriminator- in Schemas, uses this to solve name-clash issues with the standard discriminatorx-explicitMappingOnly- in Schemas, display a more descriptive property name in objects with additionalProperties when viewing the property list with an object
Releases
The README for the 1.x version is on the v1.x branch.
All the 2.x releases are deployed to npm and can be used with Redocly-cdn:
- particular release, for example,
v2.0.0: https://cdn.redoc.ly/redoc/v2.0.0/bundles/redoc.standalone.js latestrelease: https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js
Additionally, all the 1.x releases are hosted on our GitHub Pages-based CDN (deprecated):
- particular release, for example
v1.2.0: https://rebilly.github.io/ReDoc/releases/v1.2.0/redoc.min.js v1.x.xrelease: https://rebilly.github.io/ReDoc/releases/v1.x.x/redoc.min.jslatestrelease: https://rebilly.github.io/ReDoc/releases/latest/redoc.min.js - points to latest 1.x.x release since 2.x releases are not hosted on this CDN but on unpkg.
Development
see CONTRIBUTING.md
No vulnerabilities found.
Reason
15 commit(s) and 6 issue activity found in the last 90 days -- score normalized to 10
Reason
no dangerous workflow patterns detected
Reason
all changesets reviewed
Reason
no binaries found in the repo
Reason
license file detected
Details
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: MIT License: LICENSE:0
Reason
packaging workflow detected
Details
- Info: Project packages its releases by way of GitHub Actions.: .github/workflows/main.yml:6
Reason
1 existing vulnerabilities detected
Details
- Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
Reason
SAST tool is not run on all commits -- score normalized to 8
Details
- Warn: 25 commits out of 30 are checked with a SAST tool
Reason
dependency not pinned by hash detected -- score normalized to 3
Details
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs-tests.yaml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/docs-tests.yaml/main?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/docs-tests.yaml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/docs-tests.yaml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs-tests.yaml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/docs-tests.yaml/main?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/docs-tests.yaml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/docs-tests.yaml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs-tests.yaml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/docs-tests.yaml/main?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/docs-tests.yaml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/docs-tests.yaml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/e2e-tests.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/e2e-tests.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/main.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/main.yml/main?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/main.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/main.yml/main?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/main.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/main.yml/main?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/main.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/main.yml/main?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/main.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/main.yml/main?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/main.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/main.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:57: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish.yml:60: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:70: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:74: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:76: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:81: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:102: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish.yml:104: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:110: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:121: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish.yml:123: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/publish.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/unit-tests.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/Redocly/redoc/unit-tests.yml/main?enable=pin
- Warn: containerImage not pinned by hash: config/docker/Dockerfile:8: pin your Docker image by updating node:18-alpine to node:18-alpine@sha256:7e43a2d633d91e8655a6c0f45d2ed987aa4930f0792f6d9dd3bffc7496e44882
- Warn: containerImage not pinned by hash: config/docker/Dockerfile:26: pin your Docker image by updating nginx:alpine to nginx:alpine@sha256:74175cf34632e88c6cfe206897cbfe2d2fecf9bf033c40e7f9775a3689e8adc7
- Info: 0 out of 22 GitHub-owned GitHubAction dependencies pinned
- Info: 0 out of 11 third-party GitHubAction dependencies pinned
- Info: 0 out of 2 containerImage dependencies pinned
- Info: 7 out of 7 npmCommand dependencies pinned
Reason
detected GitHub workflow tokens with excessive permissions
Details
- Warn: no topLevel permission defined: .github/workflows/docs-tests.yaml:1
- Warn: no topLevel permission defined: .github/workflows/e2e-tests.yml:1
- Warn: no topLevel permission defined: .github/workflows/main.yml:1
- Warn: no topLevel permission defined: .github/workflows/publish.yml:1
- Warn: no topLevel permission defined: .github/workflows/unit-tests.yml:1
- Info: no jobLevel write permissions found
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
security policy file not detected
Details
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Score
6.7
/10
Last Scanned on 2024-11-25
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More