Upgrade docusaurus

[alexandratran]

Description

This PR upgrades Docusaurus (3.8 -> 3.9.2).
3.9.2 requires unique sidebar keys for items with the same label, so this PR fixes those duplicates.
This PR also updates the Docusaurus configuration with stricter link checking, so errors are thrown when trying to build with broken markdown links.

Issue(s) fixed

Fixes #

Preview

Checklist

• If this PR updates or adds documentation content that changes or adds technical meaning, it has received an approval from an engineer or DevRel from the relevant team.
• If this PR updates or adds documentation content, it has received an approval from a technical writer.

---

Note

Upgrade Docusaurus to 3.9.2, enforce strict broken-link checks, and add unique sidebar keys across the docs.

• Build/Config:
  • Upgrade Docusaurus and related plugins/themes from 3.8.x to 3.9.2 (incl. webpack-dev-server 5) and refresh lockfile.
  • Enforce stricter validation: onBrokenLinks: 'throw', onBrokenAnchors: 'throw', and Markdown onBrokenMarkdownLinks: 'throw'.
• Docs Navigation:
  • Add explicit key props to sidebar categories and sidebar_key frontmatter to many pages to satisfy 3.9.x unique-key requirements.
  • Minor comment fix (“internationalization”).

^{Written by Cursor Bugbot for commit 0f8c057. This will update automatically on new commits. Configure here.}

[vercel]

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

Project	Deployment	Preview	Comments	Updated (UTC)
metamask-docs	Ready	Preview	Comment	Oct 22, 2025 4:51pm

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	@​docusaurus/​tsconfig@​3.8.1 ⏵ 3.9.2			+1	+1
	@​docusaurus/​plugin-google-tag-manager@​3.8.1 ⏵ 3.9.2				+1
	@​docusaurus/​module-type-aliases@​3.8.1 ⏵ 3.9.2				+1
	@​docusaurus/​preset-classic@​3.8.1 ⏵ 3.9.2				+1
	@​docusaurus/​plugin-google-gtag@​3.8.1 ⏵ 3.9.2				+1
	@​docusaurus/​types@​3.8.1 ⏵ 3.9.2			+1	+1
	@​docusaurus/​eslint-plugin@​3.8.1 ⏵ 3.9.2	+1			+2
	@​docusaurus/​plugin-content-pages@​3.8.1 ⏵ 3.9.2				+1
	@​docusaurus/​plugin-client-redirects@​3.8.1 ⏵ 3.9.2				+1
	@​docusaurus/​core@​3.8.1 ⏵ 3.9.2	+1		+1	+1
	@​docusaurus/​theme-common@​3.8.1 ⏵ 3.9.2			+1	+1
	@​docusaurus/​theme-mermaid@​3.8.1 ⏵ 3.9.2			+2	+1
	@​docusaurus/​plugin-content-docs@​3.8.1 ⏵ 3.9.2			+1	+1
	@​docusaurus/​remark-plugin-npm2yarn@​3.8.1 ⏵ 3.9.2	-1			+1

View full report

[socket-security]

Caution

MetaMask internal reviewing guidelines:

• Do not ignore-all
• Each alert has instructions on how to review if you don't know what it means. If lost, ask your Security Liaison or the supply-chain group
• Copy-paste ignore lines for specific packages or a group of one kind with a note on what research you did to deem it safe.
  @SocketSecurity ignore npm/PACKAGE@VERSION

Action	Severity	Alert  (click "▶" to expand/collapse)
Block		@ai-sdk/provider-utils@3.0.12 has Network access. Module: globalThis["fetch"] Location: Package overview From: package-lock.json → npm/@docusaurus/preset-classic@3.9.2 → npm/@ai-sdk/provider-utils@3.0.12 ℹ Read more on: This package | This alert | What is network access? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Packages should remove all network access that is functionally unnecessary. Consumers should audit network access to ensure legitimate use. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/@ai-sdk/provider-utils@3.0.12. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Block		@ai-sdk/react@2.0.76 has Network access. Module: globalThis["fetch"] Location: Package overview From: package-lock.json → npm/@docusaurus/preset-classic@3.9.2 → npm/@ai-sdk/react@2.0.76 ℹ Read more on: This package | This alert | What is network access? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Packages should remove all network access that is functionally unnecessary. Consumers should audit network access to ensure legitimate use. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/@ai-sdk/react@2.0.76. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Block		@docsearch/react@4.2.0 has Network access. Module: globalThis["fetch"] Location: Package overview From: package-lock.json → npm/@docusaurus/preset-classic@3.9.2 → npm/@docsearch/react@4.2.0 ℹ Read more on: This package | This alert | What is network access? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Packages should remove all network access that is functionally unnecessary. Consumers should audit network access to ensure legitimate use. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/@docsearch/react@4.2.0. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Block		@vercel/oidc@3.0.3 has Network access. Module: globalThis["fetch"] Location: Package overview From: package-lock.json → npm/@docusaurus/preset-classic@3.9.2 → npm/@vercel/oidc@3.0.3 ℹ Read more on: This package | This alert | What is network access? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Packages should remove all network access that is functionally unnecessary. Consumers should audit network access to ensure legitimate use. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/@vercel/oidc@3.0.3. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Block		ai@5.0.76 has Network access. Module: globalThis["fetch"] Location: Package overview From: package-lock.json → npm/@docusaurus/preset-classic@3.9.2 → npm/ai@5.0.76 ℹ Read more on: This package | This alert | What is network access? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Packages should remove all network access that is functionally unnecessary. Consumers should audit network access to ensure legitimate use. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/ai@5.0.76. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Block		mime-types@3.0.1 has a New author. New Author: ulisesgascon Previous Author: wesleytodd From: package-lock.json → npm/@docusaurus/core@3.9.2 → npm/mime-types@3.0.1 ℹ Read more on: This package | This alert | What is new author? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Scrutinize new collaborator additions to packages because they now have the ability to publish code into your dependency tree. Packages should avoid frequent or unnecessary additions or changes to publishing rights. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/mime-types@3.0.1. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		core-js-pure@3.46.0 is a AI-detected potential code anomaly. Notes: The fragment implements a conventional abstract AsyncIterator polyfill pattern. It prevents direct construction, attaches type metadata, and exposes AsyncIteratorConstructor globally in a controlled manner. There are no signs of data exfiltration, external I/O, or hidden behavior. Overall security risk is low, malware likelihood is negligible in this fragment, and the code aligns with legitimate library usage (e.g., core-js style shims). Confidence: 1.00 Severity: 0.60 From: package-lock.json → npm/@docusaurus/core@3.9.2 → npm/core-js-pure@3.46.0 ℹ Read more on: This package | This alert | What is an AI-detected potential code anomaly? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: An AI system found a low-risk anomaly in this package. It may still be fine to use, but you should check that it is safe before proceeding. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/core-js-pure@3.46.0. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.
Warn		zod@4.1.12 is a AI-detected potential code anomaly. Notes: No explicit network exfiltration, reverse shell, or credential theft is present in this fragment. However, the code assembles and compiles arbitrary code via the Function constructor and invokes passed-in functions immediately (twice). That behavior constitutes a strong dangerous primitive (arbitrary code execution) which can be abused if any inputs (strings or args) are attacker-controlled. Treat this module as risky in threat models where inputs are not fully trusted; review call sites and sanitize/validate inputs or avoid dynamic evaluation. Confidence: 1.00 Severity: 0.60 From: package-lock.json → npm/@docusaurus/preset-classic@3.9.2 → npm/zod@4.1.12 ℹ Read more on: This package | This alert | What is an AI-detected potential code anomaly? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: An AI system found a low-risk anomaly in this package. It may still be fine to use, but you should check that it is safe before proceeding. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/zod@4.1.12. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.

View full report

[bgravenorst]

lgtm