GitHub
04/11/2026, 12:43 AM3.1.0 to 3.10.0 (the latest stable release), iterating through each minor version and verifying npm run build passes at each step.
Several swizzled theme components required fixes to keep up with upstream API changes:
| Version | Breaking change | Fix |
| ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| 3.2.x | metadata.formattedDate removed from blog post metadata | Replaced with useDateTimeFormat hook to derive month/year from metadata.date in BlogPostItem/Container |
| 3.5.x | useBlogPost / BlogPostProvider moved from @docusaurus/theme-common/internal → @docusaurus/plugin-content-blog/client | Updated all 7 swizzled blog components |
| 3.5.x | useDoc, useDocsSidebar, DocSidebarItemsExpandedStateProvider, useSidebarBreadcrumbs, useDocsVersionCandidates, and sidebar utilities moved → @docusaurus/plugin-content-docs/client | Updated all affected docs components |
| 3.9.x | copy-text-to-clipboard removed; CopyButton rewritten | Updated CodeBlock/CopyButton to use navigator.clipboard.writeText() |
| 3.10.x | @docsearch/react@4.x exports map points to non-existent per-entrypoint files | Updated SearchBar to import everything from the main @docsearch/react entry |
Checklist
• I have read the contribution guide
Was generative AI tooling used to co-author this PR?
• Yes (please specify the tool below)
Related Issues
• N/A
Summary by Sourcery
Upgrade the docs site to Docusaurus 3.10.0 and update custom theme components to align with upstream API changes.
Enhancements:
• Update swizzled blog and docs theme components to use the new plugin client entry points and date formatting utilities.
• Replace the custom code block copy utility with the standard Clipboard API for copying code snippets.
• Adjust the DocSearch modal import to use the main @docsearch/react entrypoint for compatibility with the latest version.
Build:
• Bump Docusaurus core, preset, plugin-google-gtag, and module-type-aliases dependencies to 3.10.0 and add a webpack version override for compatibility.
meltano/meltanoGitHub
04/11/2026, 12:56 AMGitHub
04/11/2026, 12:57 AM