Skip to content

Upgrade to Docusaurus 3.10#2634

Open
ctauchen wants to merge 1 commit intotigera:mainfrom
ctauchen:up-docusaurus
Open

Upgrade to Docusaurus 3.10#2634
ctauchen wants to merge 1 commit intotigera:mainfrom
ctauchen:up-docusaurus

Conversation

@ctauchen
Copy link
Copy Markdown
Collaborator

Product Version(s):

Issue:

Link to docs preview:

SME review:

  • An SME has approved this change.

DOCS review:

  • A member of the docs team has approved this change.

Additional information:

Merge checklist:

  • Deploy preview inspected wherever changes were made
  • Build completed successfully
  • Test have passed

@ctauchen ctauchen requested a review from a team as a code owner April 10, 2026 13:38
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 10, 2026

Deploy Preview for calico-docs-preview-next failed. Why did it fail? →

Name Link
🔨 Latest commit e661b22
🔍 Latest deploy log https://app.netlify.com/projects/calico-docs-preview-next/deploys/69d8fda183552d00085cc35d

Copilot AI review requested due to automatic review settings April 10, 2026 13:38
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 10, 2026

Deploy Preview succeeded!

Built without sensitive environment variables

Name Link
🔨 Latest commit e661b22
🔍 Latest deploy log https://app.netlify.com/projects/tigera/deploys/69d8fda1e91f8b0008d2d44a
😎 Deploy Preview https://deploy-preview-2634--tigera.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 72 (🔴 down 16 from production)
Accessibility: 98 (no change from production)
Best Practices: 83 (no change from production)
SEO: 100 (no change from production)
PWA: -
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Contributor

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

Upgrades the documentation site’s Docusaurus toolchain to 3.10, including associated lockfile updates and configuration changes to enable the newer future flags.

Changes:

  • Bump Docusaurus packages from 3.9.2 to 3.10.0 in package.json.
  • Refresh yarn.lock to match the upgraded Docusaurus dependency graph (notably newer DocSearch and Rspack-related packages).
  • Update docusaurus.config.js to use the newer future.v4 and future.faster configuration blocks.

Reviewed changes

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

File Description
package.json Updates Docusaurus dependency versions to ^3.10.0.
yarn.lock Locks updated dependency tree resulting from the Docusaurus upgrade.
docusaurus.config.js Migrates future configuration to the newer Docusaurus 3.10 structure and enables additional faster options.

Comment on lines 16 to +20
const config = {
future: {
experimental_faster: {
v4: {
removeLegacyPostBuildHeadAttribute: true,
useCssCascadeLayers: true,
Copy link

Copilot AI Apr 10, 2026

Choose a reason for hiding this comment

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

The new future block is mis-indented (v4: is not aligned under future:), which breaks the file’s consistent 2-space formatting and makes the config harder to scan. Please reformat this block so keys are consistently indented.

Copilot uses AI. Check for mistakes.
Comment on lines +23 to 27
mdx1CompatDisabledByDefault: true,
},
faster: {
swcJsLoader: true,
swcJsMinimizer: true,
Copy link

Copilot AI Apr 10, 2026

Choose a reason for hiding this comment

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

The new future block is also mis-indented for the faster: key (extra/missing leading spaces compared to surrounding keys). Please reformat so faster: aligns with v4: and other properties under future:.

Copilot uses AI. Check for mistakes.
@@ -37,12 +37,12 @@
"@chakra-ui/theme-tools": "2.2.6",
"@crawlee/utils": "^3.13.10",
"@docsearch/react": "^3.9.0",
Copy link

Copilot AI Apr 10, 2026

Choose a reason for hiding this comment

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

@docusaurus/theme-search-algolia@3.10.0 pulls in @docsearch/react@4.x, but this repo still pins @docsearch/react to ^3.9.0. That results in two major versions of DocSearch being installed (see yarn.lock entries for 3.9.0 and 4.6.2), which can increase bundle size and risks API/style mismatches for the custom SearchBar. Consider aligning the direct dependency to the 4.x range used by Docusaurus (or removing the direct dependency if it’s no longer needed) and verifying the custom src/theme/SearchBar continues to work.

Suggested change
"@docsearch/react": "^3.9.0",
"@docsearch/react": "^4.6.2",

Copilot uses AI. Check for mistakes.
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