From d4cae19e3faf73d983cc529035c70954b58bd325 Mon Sep 17 00:00:00 2001
From: Brandon McConnell <brandon@dreamthinkbuild.com>
Date: Wed, 1 Apr 2026 00:35:30 -0700
Subject: [PATCH 1/2] Revert "Replace S3 URLs with relative paths for theme and
 hero images (#5051)"

This reverts commit 43b3783e8c0c307297aab02639e1dcd07bb5c454.
---
 customize/themes.mdx    | 2 +-
 es/customize/themes.mdx | 2 +-
 es/index.mdx            | 4 ++--
 fr/customize/themes.mdx | 2 +-
 fr/index.mdx            | 4 ++--
 index.mdx               | 4 ++--
 zh/customize/themes.mdx | 2 +-
 zh/index.mdx            | 4 ++--
 8 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/customize/themes.mdx b/customize/themes.mdx
index f7852ba07..5d54aab39 100644
--- a/customize/themes.mdx
+++ b/customize/themes.mdx
@@ -9,7 +9,7 @@ export const ThemeCard = ({ title, value, description, href }) => {
   return (
     <a className="mt-4 gap-10 group cursor-pointer" href={href}>
       <div>
-        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`/images/themes/${value}.png`} alt={title} noZoom />
+        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/themes/${value}.png`} alt={title} noZoom />
       </div>
       <div>
         <div className="mt-4 flex space-x-2 items-center">
diff --git a/es/customize/themes.mdx b/es/customize/themes.mdx
index ac1ccf988..5a986cec4 100644
--- a/es/customize/themes.mdx
+++ b/es/customize/themes.mdx
@@ -9,7 +9,7 @@ export const ThemeCard = ({ title, value, description, href }) => {
   return (
     <a className="mt-4 gap-10 group cursor-pointer" href={href}>
       <div>
-        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`/images/themes/${value}.png`} alt={title} noZoom />
+        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/themes/${value}.png`} alt={title} noZoom />
       </div>
       <div>
         <div className="mt-4 flex space-x-2 items-center">
diff --git a/es/index.mdx b/es/index.mdx
index 0a2c40c02..59b9fdd5e 100644
--- a/es/index.mdx
+++ b/es/index.mdx
@@ -9,11 +9,11 @@ export const HeroCard = ({ filename, title, description, href }) => {
   return (
     <a className="group cursor-pointer pb-8" href={href}>
       <img
-        src={`/images/hero/${filename}.png`}
+        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}.png`}
         className="block dark:hidden pointer-events-none group-hover:scale-105 transition-all duration-100"
       />
       <img
-        src={`/images/hero/${filename}-dark.png`}
+        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}-dark.png`}
         className="pointer-events-none group-hover:scale-105 transition-all duration-100 hidden dark:block"
       />
       <h3 className="mt-5 text-gray-900 dark:text-zinc-50 font-medium">
diff --git a/fr/customize/themes.mdx b/fr/customize/themes.mdx
index 9150b64dc..8aad07bd8 100644
--- a/fr/customize/themes.mdx
+++ b/fr/customize/themes.mdx
@@ -9,7 +9,7 @@ export const ThemeCard = ({ title, value, description, href }) => {
   return (
     <a className="mt-4 gap-10 group cursor-pointer" href={href}>
       <div>
-        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`/images/themes/${value}.png`} alt={title} noZoom />
+        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/themes/${value}.png`} alt={title} noZoom />
       </div>
       <div>
         <div className="mt-4 flex space-x-2 items-center">
diff --git a/fr/index.mdx b/fr/index.mdx
index 5d8ac420e..add89f63f 100644
--- a/fr/index.mdx
+++ b/fr/index.mdx
@@ -9,11 +9,11 @@ export const HeroCard = ({ filename, title, description, href }) => {
   return (
     <a className="group cursor-pointer pb-8" href={href}>
       <img
-        src={`/images/hero/${filename}.png`}
+        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}.png`}
         className="block dark:hidden pointer-events-none group-hover:scale-105 transition-all duration-100"
       />
       <img
-        src={`/images/hero/${filename}-dark.png`}
+        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}-dark.png`}
         className="pointer-events-none group-hover:scale-105 transition-all duration-100 hidden dark:block"
       />
       <h3 className="mt-5 text-gray-900 dark:text-zinc-50 font-medium">
diff --git a/index.mdx b/index.mdx
index a5ce06e9d..b178371f8 100644
--- a/index.mdx
+++ b/index.mdx
@@ -9,11 +9,11 @@ export const HeroCard = ({ filename, title, description, href }) => {
   return (
     <a className="group cursor-pointer pb-8" href={href}>
       <img
-        src={`/images/hero/${filename}.png`}
+        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}.png`}
         className="block dark:hidden pointer-events-none group-hover:scale-105 transition-all duration-100"
       />
       <img
-        src={`/images/hero/${filename}-dark.png`}
+        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}-dark.png`}
         className="pointer-events-none group-hover:scale-105 transition-all duration-100 hidden dark:block"
       />
       <h3 className="mt-5 text-gray-900 dark:text-zinc-50 font-medium">
diff --git a/zh/customize/themes.mdx b/zh/customize/themes.mdx
index c078ac24f..a4c424e4d 100644
--- a/zh/customize/themes.mdx
+++ b/zh/customize/themes.mdx
@@ -9,7 +9,7 @@ export const ThemeCard = ({ title, value, description, href }) => {
   return (
     <a className="mt-4 gap-10 group cursor-pointer" href={href}>
       <div>
-        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`/images/themes/${value}.png`} alt={title} noZoom />
+        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/themes/${value}.png`} alt={title} noZoom />
       </div>
       <div>
         <div className="mt-4 flex space-x-2 items-center">
diff --git a/zh/index.mdx b/zh/index.mdx
index 30ab2890c..cc5bec87d 100644
--- a/zh/index.mdx
+++ b/zh/index.mdx
@@ -9,11 +9,11 @@ export const HeroCard = ({ filename, title, description, href }) => {
   return (
     <a className="group cursor-pointer pb-8" href={href}>
       <img
-        src={`/images/hero/${filename}.png`}
+        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}.png`}
         className="block dark:hidden pointer-events-none group-hover:scale-105 transition-all duration-100"
       />
       <img
-        src={`/images/hero/${filename}-dark.png`}
+        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}-dark.png`}
         className="pointer-events-none group-hover:scale-105 transition-all duration-100 hidden dark:block"
       />
       <h3 className="mt-5 text-gray-900 dark:text-zinc-50 font-medium">

From bc62e9afe05b4969992562688007d2aa973dab26 Mon Sep 17 00:00:00 2001
From: Brandon McConnell <brandon@dreamthinkbuild.com>
Date: Wed, 1 Apr 2026 00:44:50 -0700
Subject: [PATCH 2/2] fix: use GitHub raw URLs for image assets

Replace S3 bucket URLs with direct links to GitHub raw content for image assets. This provides a more consistent and reliable source for images used across the documentation pages.
---
 customize/themes.mdx    | 2 +-
 es/customize/themes.mdx | 2 +-
 es/index.mdx            | 4 ++--
 fr/customize/themes.mdx | 2 +-
 fr/index.mdx            | 4 ++--
 index.mdx               | 4 ++--
 zh/customize/themes.mdx | 2 +-
 zh/index.mdx            | 4 ++--
 8 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/customize/themes.mdx b/customize/themes.mdx
index 5d54aab39..2e488b32e 100644
--- a/customize/themes.mdx
+++ b/customize/themes.mdx
@@ -9,7 +9,7 @@ export const ThemeCard = ({ title, value, description, href }) => {
   return (
     <a className="mt-4 gap-10 group cursor-pointer" href={href}>
       <div>
-        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/themes/${value}.png`} alt={title} noZoom />
+        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`https://raw.githubusercontent.com/mintlify/docs/refs/heads/main/images/themes/${value}.png`} alt={title} noZoom />
       </div>
       <div>
         <div className="mt-4 flex space-x-2 items-center">
diff --git a/es/customize/themes.mdx b/es/customize/themes.mdx
index 5a986cec4..cce722cd5 100644
--- a/es/customize/themes.mdx
+++ b/es/customize/themes.mdx
@@ -9,7 +9,7 @@ export const ThemeCard = ({ title, value, description, href }) => {
   return (
     <a className="mt-4 gap-10 group cursor-pointer" href={href}>
       <div>
-        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/themes/${value}.png`} alt={title} noZoom />
+        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`https://raw.githubusercontent.com/mintlify/docs/refs/heads/main/images/themes/${value}.png`} alt={title} noZoom />
       </div>
       <div>
         <div className="mt-4 flex space-x-2 items-center">
diff --git a/es/index.mdx b/es/index.mdx
index 59b9fdd5e..a988cda79 100644
--- a/es/index.mdx
+++ b/es/index.mdx
@@ -9,11 +9,11 @@ export const HeroCard = ({ filename, title, description, href }) => {
   return (
     <a className="group cursor-pointer pb-8" href={href}>
       <img
-        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}.png`}
+        src={`https://raw.githubusercontent.com/mintlify/docs/refs/heads/main/images/hero/${filename}.png`}
         className="block dark:hidden pointer-events-none group-hover:scale-105 transition-all duration-100"
       />
       <img
-        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}-dark.png`}
+        src={`https://raw.githubusercontent.com/mintlify/docs/refs/heads/main/images/hero/${filename}-dark.png`}
         className="pointer-events-none group-hover:scale-105 transition-all duration-100 hidden dark:block"
       />
       <h3 className="mt-5 text-gray-900 dark:text-zinc-50 font-medium">
diff --git a/fr/customize/themes.mdx b/fr/customize/themes.mdx
index 8aad07bd8..b9052fa07 100644
--- a/fr/customize/themes.mdx
+++ b/fr/customize/themes.mdx
@@ -9,7 +9,7 @@ export const ThemeCard = ({ title, value, description, href }) => {
   return (
     <a className="mt-4 gap-10 group cursor-pointer" href={href}>
       <div>
-        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/themes/${value}.png`} alt={title} noZoom />
+        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`https://raw.githubusercontent.com/mintlify/docs/refs/heads/main/images/themes/${value}.png`} alt={title} noZoom />
       </div>
       <div>
         <div className="mt-4 flex space-x-2 items-center">
diff --git a/fr/index.mdx b/fr/index.mdx
index add89f63f..fdcfc13ea 100644
--- a/fr/index.mdx
+++ b/fr/index.mdx
@@ -9,11 +9,11 @@ export const HeroCard = ({ filename, title, description, href }) => {
   return (
     <a className="group cursor-pointer pb-8" href={href}>
       <img
-        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}.png`}
+        src={`https://raw.githubusercontent.com/mintlify/docs/refs/heads/main/images/hero/${filename}.png`}
         className="block dark:hidden pointer-events-none group-hover:scale-105 transition-all duration-100"
       />
       <img
-        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}-dark.png`}
+        src={`https://raw.githubusercontent.com/mintlify/docs/refs/heads/main/images/hero/${filename}-dark.png`}
         className="pointer-events-none group-hover:scale-105 transition-all duration-100 hidden dark:block"
       />
       <h3 className="mt-5 text-gray-900 dark:text-zinc-50 font-medium">
diff --git a/index.mdx b/index.mdx
index b178371f8..8885e44dd 100644
--- a/index.mdx
+++ b/index.mdx
@@ -9,11 +9,11 @@ export const HeroCard = ({ filename, title, description, href }) => {
   return (
     <a className="group cursor-pointer pb-8" href={href}>
       <img
-        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}.png`}
+        src={`https://raw.githubusercontent.com/mintlify/docs/refs/heads/main/images/hero/${filename}.png`}
         className="block dark:hidden pointer-events-none group-hover:scale-105 transition-all duration-100"
       />
       <img
-        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}-dark.png`}
+        src={`https://raw.githubusercontent.com/mintlify/docs/refs/heads/main/images/hero/${filename}-dark.png`}
         className="pointer-events-none group-hover:scale-105 transition-all duration-100 hidden dark:block"
       />
       <h3 className="mt-5 text-gray-900 dark:text-zinc-50 font-medium">
diff --git a/zh/customize/themes.mdx b/zh/customize/themes.mdx
index a4c424e4d..3675eae81 100644
--- a/zh/customize/themes.mdx
+++ b/zh/customize/themes.mdx
@@ -9,7 +9,7 @@ export const ThemeCard = ({ title, value, description, href }) => {
   return (
     <a className="mt-4 gap-10 group cursor-pointer" href={href}>
       <div>
-        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/themes/${value}.png`} alt={title} noZoom />
+        <img className="mt-0 rounded-2xl group-hover:scale-105 transition-all block" src={`https://raw.githubusercontent.com/mintlify/docs/refs/heads/main/images/themes/${value}.png`} alt={title} noZoom />
       </div>
       <div>
         <div className="mt-4 flex space-x-2 items-center">
diff --git a/zh/index.mdx b/zh/index.mdx
index cc5bec87d..0bcb7506f 100644
--- a/zh/index.mdx
+++ b/zh/index.mdx
@@ -9,11 +9,11 @@ export const HeroCard = ({ filename, title, description, href }) => {
   return (
     <a className="group cursor-pointer pb-8" href={href}>
       <img
-        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}.png`}
+        src={`https://raw.githubusercontent.com/mintlify/docs/refs/heads/main/images/hero/${filename}.png`}
         className="block dark:hidden pointer-events-none group-hover:scale-105 transition-all duration-100"
       />
       <img
-        src={`https://mintlify.s3.us-west-1.amazonaws.com/mintlify/images/hero/${filename}-dark.png`}
+        src={`https://raw.githubusercontent.com/mintlify/docs/refs/heads/main/images/hero/${filename}-dark.png`}
         className="pointer-events-none group-hover:scale-105 transition-all duration-100 hidden dark:block"
       />
       <h3 className="mt-5 text-gray-900 dark:text-zinc-50 font-medium">