Skip to content

chore(website): upgrade to DocSearch 4.4.0 + fix little website theming issues#11626

Merged
slorber merged 4 commits intomainfrom
slorber/docsearch-4.4.0
Dec 23, 2025
Merged

chore(website): upgrade to DocSearch 4.4.0 + fix little website theming issues#11626
slorber merged 4 commits intomainfrom
slorber/docsearch-4.4.0

Conversation

@slorber
Copy link
Copy Markdown
Collaborator

@slorber slorber commented Dec 23, 2025

Motivation

DocSearch 4.4 is out with some styling fixes we wanted: https://github.com/algolia/docsearch/releases/tag/v4.4.0

Apparently it introduces new CSS vars that may break site theming (it affected ours, cc @8bittitan) so I'm only upgrading our own website for now, and not forcing our users to upgrade immediately. If the changes are problematic, they can stay on DocSearch v4.3 for now. cc @

Test Plan

CI + Argos

@slorber slorber requested a review from Josh-Cena as a code owner December 23, 2025 15:07
@slorber slorber added the pr: maintenance This PR does not produce any behavior differences to end users when upgrading. label Dec 23, 2025
@meta-cla meta-cla bot added the CLA Signed Signed Facebook CLA label Dec 23, 2025
@socket-security
Copy link
Copy Markdown

socket-security bot commented Dec 23, 2025

@netlify
Copy link
Copy Markdown

netlify bot commented Dec 23, 2025

[V2]

Name Link
🔨 Latest commit 463c10a
🔍 Latest deploy log https://app.netlify.com/projects/docusaurus-2/deploys/694ab2e23a56750008f0596f
😎 Deploy Preview https://deploy-preview-11626--docusaurus-2.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@socket-security
Copy link
Copy Markdown

socket-security bot commented Dec 23, 2025

Warning

Review the following alerts detected in dependencies.

According to your organization's Security Policy, it is recommended to resolve "Warn" alerts. Learn more about Socket for GitHub.

Action Severity Alert  (click "▶" to expand/collapse)
Warn High
Obfuscated code: npm entities is 91.0% likely obfuscated

Confidence: 0.91

Location: Package overview

From: ?npm/@docusaurus/[email protected]npm/@docusaurus/[email protected]npm/[email protected]

ℹ Read more on: This package | This alert | What is obfuscated code?

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 [email protected].

Suggestion: Packages should not obfuscate their code. Consider not using packages with obfuscated code.

Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/[email protected]. 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 High
Obfuscated code: npm entities is 91.0% likely obfuscated

Confidence: 0.91

Location: Package overview

From: ?npm/@docusaurus/[email protected]npm/@docusaurus/[email protected]npm/[email protected]

ℹ Read more on: This package | This alert | What is obfuscated code?

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 [email protected].

Suggestion: Packages should not obfuscate their code. Consider not using packages with obfuscated code.

Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/[email protected]. 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 High
Obfuscated code: npm entities is 91.0% likely obfuscated

Confidence: 0.91

Location: Package overview

From: ?npm/@docusaurus/[email protected]npm/@docusaurus/[email protected]npm/[email protected]

ℹ Read more on: This package | This alert | What is obfuscated code?

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 [email protected].

Suggestion: Packages should not obfuscate their code. Consider not using packages with obfuscated code.

Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/[email protected]. 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 High
Obfuscated code: npm html-minifier-terser is 91.0% likely obfuscated

Confidence: 0.91

Location: Package overview

From: ?npm/@docusaurus/[email protected]npm/[email protected]

ℹ Read more on: This package | This alert | What is obfuscated code?

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 [email protected].

Suggestion: Packages should not obfuscate their code. Consider not using packages with obfuscated code.

Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/[email protected]. 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

@github-actions
Copy link
Copy Markdown

Size Change: +2.05 kB (+0.02%)

Total Size: 11.8 MB

Filename Size Change
website/build/assets/css/styles.********.css 144 kB +1.79 kB (+1.26%)
ℹ️ View Unchanged
Filename Size Change
website/.docusaurus/codeTranslations.json 2 B 0 B
website/.docusaurus/docusaurus.config.mjs 28.9 kB 0 B
website/.docusaurus/globalData.json 38.5 kB 0 B
website/.docusaurus/i18n.json 1.36 kB 0 B
website/.docusaurus/registry.js 176 kB 0 B
website/.docusaurus/routes.js 87.6 kB 0 B
website/.docusaurus/routesChunkNames.json 91.6 kB 0 B
website/.docusaurus/site-metadata.json 2.54 kB 0 B
website/build/assets/js/main.********.js 741 kB 0 B
website/build/assets/js/runtime~main.********.js 38.9 kB 0 B
website/build/blog.html 77.1 kB 0 B
website/build/blog/2017/12/14/introducing-docusaurus.html 65.5 kB 0 B
website/build/blog/2018/04/30/How-I-Converted-Profilo-To-Docusaurus.html 44.9 kB +12 B (+0.03%)
website/build/blog/2018/09/11/Towards-Docusaurus-2.html 49.2 kB 0 B
website/build/blog/2018/12/14/Happy-First-Birthday-Slash.html 29.1 kB 0 B
website/build/blog/2019/12/30/docusaurus-2019-recap.html 40 kB -1 B (0%)
website/build/blog/2020/01/07/tribute-to-endi.html 32.6 kB 0 B
website/build/blog/2021/01/19/docusaurus-2020-recap.html 51.4 kB 0 B
website/build/blog/2021/03/09/releasing-docusaurus-i18n.html 47.4 kB -1 B (0%)
website/build/blog/2021/05/12/announcing-docusaurus-two-beta.html 48 kB 0 B
website/build/blog/2021/11/21/algolia-docsearch-migration.html 54.2 kB +12 B (+0.02%)
website/build/blog/2022/01/24/docusaurus-2021-recap.html 43.4 kB 0 B
website/build/blog/2022/08/01/announcing-docusaurus-2.0.html 132 kB 0 B
website/build/blog/2022/09/01/docusaurus-2.1.html 50.1 kB -1 B (0%)
website/build/blog/archive.html 23.5 kB 0 B
website/build/blog/authors.html 50.3 kB 0 B
website/build/blog/authors/j-marcey.html 70.2 kB 0 B
website/build/blog/authors/josh-cena.html 46.8 kB 0 B
website/build/blog/authors/lex-111.html 55.6 kB 0 B
website/build/blog/authors/slorber.html 80.6 kB 0 B
website/build/blog/authors/slorber/page/2.html 80.7 kB 0 B
website/build/blog/authors/slorber/page/3.html 82.9 kB 0 B
website/build/blog/authors/slorber/page/4.html 97.5 kB 0 B
website/build/blog/authors/slorber/page/5.html 42.3 kB 0 B
website/build/blog/authors/yangshun.html 66.1 kB 0 B
website/build/blog/authors/zpao.html 47.2 kB 0 B
website/build/blog/page/2.html 77.3 kB 0 B
website/build/blog/page/3.html 80.2 kB 0 B
website/build/blog/page/4.html 87.6 kB 0 B
website/build/blog/page/5.html 62.4 kB 0 B
website/build/blog/page/6.html 38 kB 0 B
website/build/blog/preparing-your-site-for-docusaurus-v3.html 125 kB +4 B (0%)
website/build/blog/releases/2.2.html 50.3 kB 0 B
website/build/blog/releases/2.3.html 60.6 kB 0 B
website/build/blog/releases/2.4.html 64.1 kB 0 B
website/build/blog/releases/3.0.html 105 kB 0 B
website/build/blog/releases/3.1.html 53.1 kB +1 B (0%)
website/build/blog/releases/3.2.html 48.9 kB 0 B
website/build/blog/releases/3.3.html 56 kB 0 B
website/build/blog/releases/3.4.html 55.1 kB +7 B (+0.01%)
website/build/blog/releases/3.5.html 57.8 kB +1 B (0%)
website/build/blog/releases/3.6.html 76.1 kB +1 B (0%)
website/build/blog/releases/3.7.html 50.6 kB +1 B (0%)
website/build/blog/releases/3.8.html 85.4 kB 0 B
website/build/blog/releases/3.9.html 60.4 kB 0 B
website/build/blog/tags.html 27.2 kB 0 B
website/build/blog/upgrading-frontend-dependencies-with-confidence-using-visual-regression-testing.html 123 kB 0 B
website/build/docs.html 48.4 kB 0 B
website/build/docs/advanced.html 30 kB 0 B
website/build/docs/advanced/architecture.html 29.5 kB +4 B (+0.01%)
website/build/docs/advanced/client.html 68.5 kB 0 B
website/build/docs/advanced/plugins.html 54 kB 0 B
website/build/docs/advanced/routing.html 69 kB +8 B (+0.01%)
website/build/docs/advanced/ssg.html 73.2 kB 0 B
website/build/docs/api/docusaurus-config.html 227 kB +2 B (0%)
website/build/docs/api/misc/@docusaurus/eslint-plugin.html 44.1 kB +4 B (+0.01%)
website/build/docs/api/misc/@docusaurus/eslint-plugin/no-html-links.html 35.6 kB 0 B
website/build/docs/api/misc/@docusaurus/eslint-plugin/no-untranslated-text.html 34.6 kB 0 B
website/build/docs/api/misc/@docusaurus/eslint-plugin/prefer-docusaurus-heading.html 35.9 kB +4 B (+0.01%)
website/build/docs/api/misc/@docusaurus/eslint-plugin/string-literal-i18n-messages.html 39.4 kB 0 B
website/build/docs/api/misc/@docusaurus/logger.html 38 kB 0 B
website/build/docs/api/misc/create-docusaurus.html 33.1 kB 0 B
website/build/docs/api/misc/docusaurus-init/index.html 361 B 0 B
website/build/docs/api/plugin-methods.html 64 kB +4 B (+0.01%)
website/build/docs/api/plugin-methods/extend-infrastructure.html 58.1 kB +4 B (+0.01%)
website/build/docs/api/plugin-methods/i18n-lifecycles.html 56.5 kB +4 B (+0.01%)
website/build/docs/api/plugin-methods/lifecycle-apis.html 157 kB 0 B
website/build/docs/api/plugin-methods/static-methods.html 43.9 kB +4 B (+0.01%)
website/build/docs/api/plugins.html 32.4 kB +4 B (+0.01%)
website/build/docs/api/plugins/@docusaurus/plugin-client-redirects.html 58.9 kB +13 B (+0.02%)
website/build/docs/api/plugins/@docusaurus/plugin-content-blog.html 182 kB 0 B
website/build/docs/api/plugins/@docusaurus/plugin-content-docs.html 189 kB 0 B
website/build/docs/api/plugins/@docusaurus/plugin-content-pages.html 73.4 kB 0 B
website/build/docs/api/plugins/@docusaurus/plugin-css-cascade-layers.html 46.8 kB 0 B
website/build/docs/api/plugins/@docusaurus/plugin-debug.html 47.4 kB +12 B (+0.03%)
website/build/docs/api/plugins/@docusaurus/plugin-google-analytics.html 48.9 kB +3 B (+0.01%)
website/build/docs/api/plugins/@docusaurus/plugin-google-gtag.html 48.4 kB -4 B (-0.01%)
website/build/docs/api/plugins/@docusaurus/plugin-google-tag-manager.html 47.2 kB 0 B
website/build/docs/api/plugins/@docusaurus/plugin-ideal-image.html 51 kB 0 B
website/build/docs/api/plugins/@docusaurus/plugin-pwa.html 115 kB +4 B (0%)
website/build/docs/api/plugins/@docusaurus/plugin-rsdoctor.html 40 kB 0 B
website/build/docs/api/plugins/@docusaurus/plugin-sitemap.html 64.7 kB +6 B (+0.01%)
website/build/docs/api/plugins/@docusaurus/plugin-svgr.html 45 kB 0 B
website/build/docs/api/plugins/@docusaurus/plugin-vercel-analytics.html 40.4 kB +12 B (+0.03%)
website/build/docs/api/themes.html 29.4 kB 0 B
website/build/docs/api/themes/@docusaurus/theme-classic.html 42.6 kB +4 B (+0.01%)
website/build/docs/api/themes/@docusaurus/theme-live-codeblock.html 35.8 kB +2 B (+0.01%)
website/build/docs/api/themes/@docusaurus/theme-mermaid.html 34.6 kB +4 B (+0.01%)
website/build/docs/api/themes/@docusaurus/theme-search-algolia.html 32.5 kB 0 B
website/build/docs/api/themes/configuration.html 246 kB 0 B
website/build/docs/blog.html 198 kB 0 B
website/build/docs/browser-support.html 46.9 kB 0 B
website/build/docs/category/getting-started.html 27 kB 0 B
website/build/docs/category/guides.html 35.6 kB 0 B
website/build/docs/cli.html 58.8 kB 0 B
website/build/docs/configuration.html 90.1 kB +7 B (+0.01%)
website/build/docs/create-doc.html 60.3 kB +3 B (0%)
website/build/docs/creating-pages.html 56 kB +1 B (0%)
website/build/docs/deployment.html 210 kB +5 B (0%)
website/build/docs/docs-introduction.html 49.6 kB 0 B
website/build/docs/docs-multi-instance.html 72 kB +4 B (+0.01%)
website/build/docs/docusaurus-core.html 219 kB 0 B
website/build/docs/guides/whats-next.html 32.3 kB 0 B
website/build/docs/i18n/crowdin.html 141 kB +12 B (+0.01%)
website/build/docs/i18n/git.html 75.8 kB +4 B (+0.01%)
website/build/docs/i18n/introduction.html 48.4 kB 0 B
website/build/docs/i18n/tutorial.html 162 kB 0 B
website/build/docs/installation.html 63.3 kB 0 B
website/build/docs/introduction/index.html 280 B 0 B
website/build/docs/markdown-features.html 78.6 kB 0 B
website/build/docs/markdown-features/admonitions.html 109 kB +4 B (0%)
website/build/docs/markdown-features/assets.html 84.9 kB +2 B (0%)
website/build/docs/markdown-features/code-blocks.html 215 kB +7 B (0%)
website/build/docs/markdown-features/diagrams.html 53.8 kB +9 B (+0.02%)
website/build/docs/markdown-features/head-metadata.html 50.2 kB 0 B
website/build/docs/markdown-features/links.html 40.4 kB +1 B (0%)
website/build/docs/markdown-features/math-equations.html 88.1 kB +4 B (0%)
website/build/docs/markdown-features/plugins.html 93.9 kB +8 B (+0.01%)
website/build/docs/markdown-features/react.html 130 kB 0 B
website/build/docs/markdown-features/tabs.html 137 kB 0 B
website/build/docs/markdown-features/toc.html 81.8 kB +4 B (0%)
website/build/docs/migration.html 38.2 kB +4 B (+0.01%)
website/build/docs/migration/v2.html 38.9 kB 0 B
website/build/docs/migration/v2/automated.html 39.3 kB 0 B
website/build/docs/migration/v2/manual.html 185 kB 0 B
website/build/docs/migration/v2/translated-sites.html 50.1 kB 0 B
website/build/docs/migration/v2/versioned-sites.html 59 kB +8 B (+0.01%)
website/build/docs/migration/v3.html 187 kB +2 B (0%)
website/build/docs/playground.html 31 kB 0 B
website/build/docs/resources/index.html 325 B 0 B
website/build/docs/search.html 121 kB +2 B (0%)
website/build/docs/seo.html 86.3 kB +13 B (+0.02%)
website/build/docs/sidebar.html 133 kB +1 B (0%)
website/build/docs/sidebar/autogenerated.html 143 kB 0 B
website/build/docs/sidebar/items.html 170 kB +1 B (0%)
website/build/docs/sidebar/multiple-sidebars.html 60.8 kB +4 B (+0.01%)
website/build/docs/static-assets.html 50.9 kB +4 B (+0.01%)
website/build/docs/styling-layout.html 133 kB +1 B (0%)
website/build/docs/support/index.html 319 B 0 B
website/build/docs/swizzling.html 109 kB +14 B (+0.01%)
website/build/docs/team/index.html 310 B 0 B
website/build/docs/typescript-support.html 58.9 kB +4 B (+0.01%)
website/build/docs/using-plugins.html 104 kB 0 B
website/build/docs/versioning.html 89.9 kB -2 B (0%)
website/build/index.html 35.3 kB 0 B

compressed-size-action::DOCUSAURUS_INFRA_FASTER

@github-actions
Copy link
Copy Markdown

github-actions bot commented Dec 23, 2025

⚡️ Lighthouse report for the deploy preview of this PR

URL Performance Accessibility Best Practices SEO Report
/ 🔴 46 🟢 98 🟢 100 🟢 100 Report
/docs/installation 🟠 57 🟢 97 🟢 100 🟢 100 Report
/docs/category/getting-started 🟠 71 🟢 100 🟢 100 🟠 86 Report
/blog 🟠 67 🟢 96 🟢 100 🟠 86 Report
/blog/preparing-your-site-for-docusaurus-v3 🟠 65 🟢 92 🟢 100 🟢 100 Report
/blog/tags/release 🟠 69 🟢 96 🟢 100 🟠 86 Report
/blog/tags 🟠 68 🟢 100 🟢 100 🟠 86 Report

@slorber slorber added the Argos Add this label to run UI visual regression tests. See argos.yml GH action. label Dec 23, 2025
@argos-ci
Copy link
Copy Markdown

argos-ci bot commented Dec 23, 2025

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build Status Details Updated (UTC)
default (Inspect) ⚠️ Changes detected (Review) 1 added Dec 23, 2025, 3:26 PM

@slorber slorber merged commit 5bc5c90 into main Dec 23, 2025
35 of 40 checks passed
@slorber slorber deleted the slorber/docsearch-4.4.0 branch December 23, 2025 15:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Argos Add this label to run UI visual regression tests. See argos.yml GH action. CLA Signed Signed Facebook CLA pr: maintenance This PR does not produce any behavior differences to end users when upgrading.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant