Skip to content

fix: remove unused openapi-docs theme to fix Vercel build#999

Merged
nud3l merged 1 commit intomasterfrom
fix/remove-openapi-docs-theme
Mar 17, 2026
Merged

fix: remove unused openapi-docs theme to fix Vercel build#999
nud3l merged 1 commit intomasterfrom
fix/remove-openapi-docs-theme

Conversation

@nud3l
Copy link
Copy Markdown
Contributor

@nud3l nud3l commented Mar 17, 2026

Summary

  • Removes docusaurus-theme-openapi-docs, docusaurus-plugin-openapi-docs, and related deps (react-redux, redux, @reduxjs/toolkit) that cause webpack 5 path polyfill errors
  • Removes @theme/ApiItem doc item component override and Root.js theme wrapper that depended on the openapi theme
  • Cherry-picked from feat: auto-generate supported routes docs page (#949) #979 to unblock all Vercel deployments (production + preview have been failing for days)

Test plan

  • Verify Vercel preview deploys successfully
  • Verify docs site renders correctly without openapi theme

🤖 Generated with Claude Code

The docusaurus-theme-openapi-docs and docusaurus-plugin-openapi-docs
packages are no longer used — API docs are served by Mintlify. Their
transitive dep postman-code-generators requires Node.js 'path' which
webpack 5 cannot resolve, causing Vercel build failures.

Removes: openapi-docs theme/plugin, postman-code-generators (transitive),
react-redux, @reduxjs/toolkit, and the Redux provider wrapper in Root.js.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel bot commented Mar 17, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
bob-docs Ready Ready Preview, Comment Mar 17, 2026 2:57pm

Request Review

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request addresses critical Vercel build failures by systematically removing unused OpenAPI documentation components and their associated dependencies from the Docusaurus project. The changes streamline the build process and ensure successful deployments by eliminating conflicts related to Webpack 5 polyfills.

Highlights

  • Dependency Removal: Removed docusaurus-theme-openapi-docs, docusaurus-plugin-openapi-docs, and associated Redux dependencies (react-redux, redux, @reduxjs/toolkit) which were causing Webpack 5 path polyfill errors.
  • Theme Component Cleanup: Eliminated the @theme/ApiItem doc item component override and the Root.js theme wrapper, both of which were dependent on the OpenAPI theme.
  • Vercel Build Fix: This change was cherry-picked from a previous pull request (feat: auto-generate supported routes docs page (#949) #979) to urgently resolve persistent Vercel deployment failures for both production and preview environments.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • docs/docusaurus.config.js
    • Removed the docItemComponent override for @theme/ApiItem.
    • Eliminated api and languageTabs configurations from themeConfig.
    • Unregistered docusaurus-theme-openapi-docs from the list of active themes.
  • docs/package.json
    • Uninstalled docusaurus-plugin-openapi-docs and docusaurus-theme-openapi-docs.
    • Removed Redux-related dependencies: @reduxjs/toolkit, react-redux, and redux.
  • docs/src/theme/Root.js
    • Removed the import and usage of Provider from react-redux.
    • Eliminated the import of createStoreWithoutState from @theme/ApiItem/store.
    • Refactored the Root component to directly render its children, removing Redux store initialization.
Activity
  • The pull request was created to fix urgent Vercel build failures that had been occurring for several days.
  • The changes were cherry-picked from an existing pull request (feat: auto-generate supported routes docs page (#949) #979) to expedite the fix.
  • A test plan was outlined to verify successful Vercel preview deployments and correct rendering of the docs site without the OpenAPI theme.
  • The pull request was generated using Claude Code.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

The pull request successfully removes the docusaurus-theme-openapi-docs and related dependencies, configurations, and theme overrides. These changes directly address the Vercel build failures caused by webpack 5 path polyfill errors, as described in the pull request summary. The modifications are clean and consistent across docusaurus.config.js, package.json, and src/theme/Root.js, effectively eliminating the unused components.

@nud3l nud3l enabled auto-merge (squash) March 17, 2026 14:57
@nud3l nud3l merged commit 7384c0a into master Mar 17, 2026
7 checks passed
@nud3l nud3l deleted the fix/remove-openapi-docs-theme branch March 17, 2026 15:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant