Skip to content

website: add @docusaurus/faster and bump Docusaurus to 3.10.0#35

Merged
kou merged 2 commits intomainfrom
copilot/fix-docusaurus-build-failure
Apr 13, 2026
Merged

website: add @docusaurus/faster and bump Docusaurus to 3.10.0#35
kou merged 2 commits intomainfrom
copilot/fix-docusaurus-build-failure

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 13, 2026

Docusaurus 3.10.0 requires @docusaurus/faster to be present as an explicit dependency — without it, the build fails immediately with ERR_MODULE_NOT_FOUND when the bundler attempts to import it.

Changes

  • website/package.json: Bump all @docusaurus/* packages 3.9.2 → 3.10.0; add @docusaurus/faster: "3.10.0" as a direct dependency
  • website/package-lock.json: Regenerated via npm install
Original prompt

Create a PR that fixes the failing GitHub Actions job in enactic/damiao (run 24333899416, job 71045883752).

Failure details (from job logs, ref e866ae0b902c3c104a64644cd4cfb85985e9d7b4): Docusaurus build fails with:

  • "To enable Docusaurus Faster options, your site must add the @docusaurus/faster package as a dependency."
  • "Cannot find package '@docusaurus/faster' ... ERR_MODULE_NOT_FOUND"

Implement Option A:

  1. Add @docusaurus/faster as a dependency in website/package.json, pinned to the same version as other Docusaurus packages (3.10.0).
  2. Update website/package-lock.json accordingly (regenerate with npm so CI uses the new dependency).
  3. Ensure npm ci + npm run build works.

Relevant files:

  • .github/workflows/website.yaml (build uses npm ci then npm run build from website/)
  • website/package.json
  • (update) website/package-lock.json

Keep changes minimal: only dependency addition + lockfile update.

The following is the prior conversation context from the user's chat exploration (may be truncated):

User: Please find a solution for this failing job. Use the logs, job definition, and any referenced files where the failure occurred. Keep your response focused on the solution and include code suggestions when appropriate.

Assistant: The job is failing during npm run build (Docusaurus build) for locale ja because Docusaurus is trying to use the “Faster” bundler option (Rspack) but your site does not have @docusaurus/faster installed:

  • Log error: To enable Docusaurus Faster options, your site must add the @docusaurus/faster package as a dependency.
  • Followed by: Cannot find package '@docusaurus/faster' ... ERR_MODULE_NOT_FOUND
  • This occurs while building locale ja, but it will block the build overall.

Fix option A (recommended): Add the missing dependency

Update website/package.json to include @docusaurus/faster with the same version as your Docusaurus packages (3.10.0), then regenerate the lockfile.

Suggested change (website/package.json):

{
  "dependencies": {
    "@docusaurus/core": "3.10.0",
    "@docusaurus/preset-classic": "3.10.0",
    "@docusaurus/faster": "3.10.0",
    "@mdx-js/react": "^3.0.0",
    "clsx": "^2.0.0",
    "prism-react-renderer": "^2.3.0",
    "react": "^19.0.0",
    "react-dom": "^19.2.4"
  }
}

Then run (locally) from website/ and commit both files:

npm install
# or: npm install @docusaurus/faster@3.10.0

This aligns with what Docusaurus expects when the faster/Rspack path is enabled implicitly by the environment/config.

Fix option B: Disable “Faster” mode (if you don’t want it)

If you didn’t intend to use the Faster/Rspack pipeline, disable it explicitly in your Docusaurus configuration/build environment so it uses the default bundler.

Practical approaches (pick one that matches how your repo enables it):

  • Remove any env var(s) enabling faster mode in the workflow/build scripts (often DOCUSAURUS_FASTER, USE_RSPACK, etc., depending on setup).
  • Or set the appropriate config flag to disable faster mode in website/docusaurus.config.ts (exact key depends on Docusaurus’ versioned API; the log indicates it’s being enabled somewhere today).

Given your workflow (.github/workflows/website.yaml) is just running npm run build without custom env flags, the simplest and most robust fix is Option A (add @docusaurus/faster).

Notes specific to your CI environment

The logs show Node v24.14.1 is used. Your website/package.json only requires >=20.0, so Node 24 is allowed—but if you want maximum Docusaurus ecosystem stability, you can also pin Node to an LTS version (e.g., 22) in .github/workflows/website.yaml. This isn’t the root cause here, but it can reduce surprises.

Where the failure happens:

  • Workflow: .github/workflows/website.yaml (Build step runs npm run build)
  • Site: website/ with Docusaurus 3.10.0
  • Error: missing dependency @docusaurus/faster during docusaurus build for locale ja

User: Open a PR for the option A.

Assistant: I’ve queued up the pull request creation with the fix (adding @docusaurus/faster@3.10.0 to website/package.json and updating website/package-lock.json), and I’m waiting for your confirmation in the dialog to proceed and open the PR.

This pull request was created from Copilot chat.

Copilot AI changed the title [WIP] Fix failing GitHub Actions job by adding @docusaurus/faster dependency website: add @docusaurus/faster and bump Docusaurus to 3.10.0 Apr 13, 2026
Copilot AI requested a review from kou April 13, 2026 08:50
Copilot finished work on behalf of kou April 13, 2026 08:50
@kou kou marked this pull request as ready for review April 13, 2026 09:04
Copilot AI review requested due to automatic review settings April 13, 2026 09:04
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the Docusaurus website dependencies to resolve CI build failures caused by Docusaurus 3.10+ requiring @docusaurus/faster to be installed explicitly.

Changes:

  • Bump Docusaurus packages from 3.9.2 to 3.10.0.
  • Add @docusaurus/faster@3.10.0 as a direct dependency.
  • Regenerate website/package-lock.json to include the new dependency and updated transitive versions.

Reviewed changes

Copilot reviewed 1 out of 2 changed files in this pull request and generated no comments.

File Description
website/package.json Adds @docusaurus/faster and aligns Docusaurus package versions on 3.10.0.
website/package-lock.json Lockfile regeneration reflecting the new dependency and Docusaurus 3.10.0 dependency graph.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@kou kou merged commit 130ae09 into main Apr 13, 2026
8 checks passed
@kou kou deleted the copilot/fix-docusaurus-build-failure branch April 13, 2026 09:33
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.

3 participants