Skip to content

Docusaurus 3.7.0 support #1072

@markrzen

Description

@markrzen

Describe the bug

Generating a new Docusaurus project, then attempting to install docusaurus-openapi-docs results in peerDependencies exceptions.

Expected behavior

According to the README, 3.7.0 is supported.
REL: https://github.com/PaloAltoNetworks/docusaurus-openapi-docs?tab=readme-ov-file#compatibility-matrix

Current behavior

npm error While resolving: sandbox@0.0.0
npm error Found: react@19.0.0
npm error node_modules/react
npm error   react@"^19.0.0" from the root project
npm error   peer react@"^18.0.0 || ^19.0.0" from @docusaurus/plugin-content-docs@3.7.0
npm error   node_modules/@docusaurus/plugin-content-docs
npm error     peer @docusaurus/plugin-content-docs@"^3.5.0" from docusaurus-plugin-openapi-docs@4.3.2
npm error     node_modules/docusaurus-plugin-openapi-docs
npm error       docusaurus-plugin-openapi-docs@"*" from the root project
npm error   1 more (react-dom)
npm error
npm error Could not resolve dependency:
npm error peer react@"^16.8.4 || ^17.0.0 || ^18.0.0" from docusaurus-plugin-openapi-docs@4.3.2
npm error node_modules/docusaurus-plugin-openapi-docs
npm error   docusaurus-plugin-openapi-docs@"*" from the root project

Possible solution

Adjust peerDependencies to later versions.

"react": "^16.8.4 || ^17.0.0 || ^18.0.0 || ^19.0.0"

Steps to reproduce

  1. Generate new docusaurus project
  2. npm i -S docusaurus-openapi-docs

Screenshots

Context

Prevents usage without override stop-gap

  "overrides": {
    "react": "^19.0.0",
    "react-dom": "^19.0.0"
  },

Your Environment

Latest Node 20 and packaged NPM

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions