From cb886c66d16c072b1b994fb4832672389c0a32e6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Denny=20Mor=C3=A1n?= <info@softwec.dev>
Date: Wed, 11 Mar 2026 14:03:38 -0500
Subject: [PATCH 1/4] fix(theme): hide CopyButton in non-secure contexts where
 clipboard API is unavailable

---
 .../src/theme/CodeBlock/Buttons/CopyButton/index.tsx     | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/packages/docusaurus-theme-classic/src/theme/CodeBlock/Buttons/CopyButton/index.tsx b/packages/docusaurus-theme-classic/src/theme/CodeBlock/Buttons/CopyButton/index.tsx
index a09400029890..4301bcd12e56 100644
--- a/packages/docusaurus-theme-classic/src/theme/CodeBlock/Buttons/CopyButton/index.tsx
+++ b/packages/docusaurus-theme-classic/src/theme/CodeBlock/Buttons/CopyButton/index.tsx
@@ -44,6 +44,10 @@ function ariaLabel(isCopied: boolean) {
       });
 }
 
+function useClipboardSupported() {
+  return typeof navigator !== 'undefined' && !!navigator.clipboard;
+}
+
 function useCopyButton() {
   const {
     metadata: {code},
@@ -66,8 +70,13 @@ function useCopyButton() {
 }
 
 export default function CopyButton({className}: Props): ReactNode {
+  const isClipboardSupported = useClipboardSupported();
   const {copyCode, isCopied} = useCopyButton();
 
+  if (!isClipboardSupported) {
+    return null;
+  }
+
   return (
     <Button
       aria-label={ariaLabel(isCopied)}

From 93b30393922f4fa0233db079f7bf1acf4a809be7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Denny=20Mor=C3=A1n?= <info@softwec.dev>
Date: Wed, 11 Mar 2026 14:12:01 -0500
Subject: [PATCH 2/4] fix(theme): restore copy-text-to-clipboard as lazy
 fallback for non-secure contexts

---
 .../docusaurus-theme-classic/package.json     |  1 +
 .../CodeBlock/Buttons/CopyButton/index.tsx    | 23 +++++++++++--------
 2 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/packages/docusaurus-theme-classic/package.json b/packages/docusaurus-theme-classic/package.json
index 63fcff4e0a3d..09fa053d21a4 100644
--- a/packages/docusaurus-theme-classic/package.json
+++ b/packages/docusaurus-theme-classic/package.json
@@ -35,6 +35,7 @@
     "@docusaurus/utils-validation": "3.9.2",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
+    "copy-text-to-clipboard": "^3.2.0",
     "infima": "0.2.0-alpha.45",
     "lodash": "^4.17.21",
     "nprogress": "^0.2.0",
diff --git a/packages/docusaurus-theme-classic/src/theme/CodeBlock/Buttons/CopyButton/index.tsx b/packages/docusaurus-theme-classic/src/theme/CodeBlock/Buttons/CopyButton/index.tsx
index 4301bcd12e56..44bcd4320e73 100644
--- a/packages/docusaurus-theme-classic/src/theme/CodeBlock/Buttons/CopyButton/index.tsx
+++ b/packages/docusaurus-theme-classic/src/theme/CodeBlock/Buttons/CopyButton/index.tsx
@@ -44,10 +44,6 @@ function ariaLabel(isCopied: boolean) {
       });
 }
 
-function useClipboardSupported() {
-  return typeof navigator !== 'undefined' && !!navigator.clipboard;
-}
-
 function useCopyButton() {
   const {
     metadata: {code},
@@ -56,12 +52,24 @@ function useCopyButton() {
   const copyTimeout = useRef<number | undefined>(undefined);
 
   const copyCode = useCallback(() => {
-    navigator.clipboard.writeText(code).then(() => {
+    // Use the native clipboard API in secure contexts (HTTPS / localhost).
+    // Fall back to copy-text-to-clipboard for non-secure contexts (e.g. HTTP
+    // on a local network). The fallback is lazily loaded to avoid bundle
+    // overhead for the common HTTPS case.
+    const copyPromise = navigator.clipboard
+      ? navigator.clipboard.writeText(code)
+      : import('copy-text-to-clipboard').then(({default: copy}) => {
+          copy(code);
+        });
+
+    copyPromise.then(() => {
       setIsCopied(true);
       copyTimeout.current = window.setTimeout(() => {
         setIsCopied(false);
       }, 1000);
     });
+    // Errors are intentionally not caught so they remain unhandled and can
+    // be captured by observability tools (e.g. Sentry, PostHog).
   }, [code]);
 
   useEffect(() => () => window.clearTimeout(copyTimeout.current), []);
@@ -70,13 +78,8 @@ function useCopyButton() {
 }
 
 export default function CopyButton({className}: Props): ReactNode {
-  const isClipboardSupported = useClipboardSupported();
   const {copyCode, isCopied} = useCopyButton();
 
-  if (!isClipboardSupported) {
-    return null;
-  }
-
   return (
     <Button
       aria-label={ariaLabel(isCopied)}

From 42fe02bc46692202b685dbd438bed6a8f70365db Mon Sep 17 00:00:00 2001
From: sebastien <lorber.sebastien@gmail.com>
Date: Thu, 12 Mar 2026 16:43:19 +0100
Subject: [PATCH 3/4] copyToClipboard abstraction

---
 .../CodeBlock/Buttons/CopyButton/index.tsx    | 25 +++++++++++--------
 1 file changed, 14 insertions(+), 11 deletions(-)

diff --git a/packages/docusaurus-theme-classic/src/theme/CodeBlock/Buttons/CopyButton/index.tsx b/packages/docusaurus-theme-classic/src/theme/CodeBlock/Buttons/CopyButton/index.tsx
index 44bcd4320e73..849b9fa32017 100644
--- a/packages/docusaurus-theme-classic/src/theme/CodeBlock/Buttons/CopyButton/index.tsx
+++ b/packages/docusaurus-theme-classic/src/theme/CodeBlock/Buttons/CopyButton/index.tsx
@@ -44,6 +44,19 @@ function ariaLabel(isCopied: boolean) {
       });
 }
 
+async function copyToClipboard(text: string) {
+  // The clipboard API is only defined in secure contexts (HTTPS / localhost).
+  // See https://developer.mozilla.org/en-US/docs/Web/API/Clipboard
+  if (navigator.clipboard) {
+    return navigator.clipboard.writeText(text);
+  }
+  // Fall back to copy-text-to-clipboard for non-secure contexts (e.g. HTTP
+  // on a local network). The fallback is lazily loaded to avoid bundle
+  // overhead for the common HTTPS case.
+  const {default: copy} = await import('copy-text-to-clipboard');
+  return copy(text);
+}
+
 function useCopyButton() {
   const {
     metadata: {code},
@@ -52,17 +65,7 @@ function useCopyButton() {
   const copyTimeout = useRef<number | undefined>(undefined);
 
   const copyCode = useCallback(() => {
-    // Use the native clipboard API in secure contexts (HTTPS / localhost).
-    // Fall back to copy-text-to-clipboard for non-secure contexts (e.g. HTTP
-    // on a local network). The fallback is lazily loaded to avoid bundle
-    // overhead for the common HTTPS case.
-    const copyPromise = navigator.clipboard
-      ? navigator.clipboard.writeText(code)
-      : import('copy-text-to-clipboard').then(({default: copy}) => {
-          copy(code);
-        });
-
-    copyPromise.then(() => {
+    copyToClipboard(code).then(() => {
       setIsCopied(true);
       copyTimeout.current = window.setTimeout(() => {
         setIsCopied(false);

From 0421483e01b19b9fd6ccbaa4d6abf6c5ccc2f65c Mon Sep 17 00:00:00 2001
From: sebastien <lorber.sebastien@gmail.com>
Date: Thu, 12 Mar 2026 16:55:47 +0100
Subject: [PATCH 4/4] missing lockfile

---
 yarn.lock | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/yarn.lock b/yarn.lock
index 7f9b9a8df2e8..07c274a231b6 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -6907,6 +6907,11 @@ cookie@~0.4.1:
   resolved "https://registry.yarnpkg.com/cookie/-/cookie-0.4.2.tgz#0e41f24de5ecf317947c82fc789e06a884824432"
   integrity sha512-aSWTXFzaKWkvHO1Ny/s+ePFpvKsPnjc551iI41v3ny/ow6tBG5Vd+FuqGNhh1LxOmVzOlGUriIlOaokOvhaStA==
 
+copy-text-to-clipboard@^3.2.0:
+  version "3.2.2"
+  resolved "https://registry.yarnpkg.com/copy-text-to-clipboard/-/copy-text-to-clipboard-3.2.2.tgz#99bc79db3f2d355ec33a08d573aff6804491ddb9"
+  integrity sha512-T6SqyLd1iLuqPA90J5N4cTalrtovCySh58iiZDGJ6FGznbclKh4UI+FGacQSgFzwKG77W7XT5gwbVEbd9cIH1A==
+
 copy-webpack-plugin@^11.0.0:
   version "11.0.0"
   resolved "https://registry.yarnpkg.com/copy-webpack-plugin/-/copy-webpack-plugin-11.0.0.tgz#96d4dbdb5f73d02dd72d0528d1958721ab72e04a"