From 883dbfd6894a3028f301e5e36127faa9a10df2dc Mon Sep 17 00:00:00 2001
From: Victor Berchet <victor@suumit.com>
Date: Mon, 24 Mar 2025 08:55:45 +0100
Subject: [PATCH] [cloudflare] Add an HowTo for Cloudfalre images Update
 pages/cloudflare/howtos/image.mdx

Co-authored-by: James Anderson <james@eli.cx>
fixup! middleware
---
 pages/cloudflare/howtos/_meta.json |  3 +-
 pages/cloudflare/howtos/image.mdx  | 64 ++++++++++++++++++++++++++++++
 pages/cloudflare/index.mdx         |  2 +-
 3 files changed, 67 insertions(+), 2 deletions(-)
 create mode 100644 pages/cloudflare/howtos/image.mdx

diff --git a/pages/cloudflare/howtos/_meta.json b/pages/cloudflare/howtos/_meta.json
index 2dae0f9..e4803ff 100644
--- a/pages/cloudflare/howtos/_meta.json
+++ b/pages/cloudflare/howtos/_meta.json
@@ -2,5 +2,6 @@
   "NextAuth": "NextAuth",
   "stripeAPI": "Stripe API",
   "dev": "Development workflow",
-  "env-vars": "Enviroment Variables"
+  "env-vars": "Enviroment Variables",
+  "image": "Image Optimization"
 }
diff --git a/pages/cloudflare/howtos/image.mdx b/pages/cloudflare/howtos/image.mdx
new file mode 100644
index 0000000..fd4e2ae
--- /dev/null
+++ b/pages/cloudflare/howtos/image.mdx
@@ -0,0 +1,64 @@
+import { Callout } from "nextra/components";
+
+## Image Optimization
+
+Next.js has a builtin [`<Image>` component](https://nextjs.org/docs/pages/building-your-application/optimizing/images) to automatically optimize your images for faster page loads.
+
+In this post, we will look at how to integrate the Next.js image optimization with [Cloudflare Images](https://developers.cloudflare.com/images)
+
+### Enable Cloudflare Images
+
+You first need to [enable Cloudflare Images](https://developers.cloudflare.com/images/get-started/#enable-transformations-on-your-zone) for your zone.
+
+It is strongly advised to restrict the image origins that can be transformed to where your images are hosted, i.e. a [R2 bucket](https://developers.cloudflare.com/r2/buckets/).
+
+### Use a custom loader
+
+You then need to configure your Next application to use a custom loader for Cloudflare Images.
+
+Create an `image-loader.ts` at the root of your application:
+
+```ts
+// image-loader.ts
+import type { ImageLoaderProps } from "next/image";
+
+const normalizeSrc = (src: string) => {
+  return src.startsWith("/") ? src.slice(1) : src;
+};
+
+export default function cloudflareLoader({ src, width, quality }: ImageLoaderProps) {
+  if (process.env.NODE_ENV === "development") {
+    // Serve the original image when using `next dev`
+    return src;
+  }
+  const params = [`width=${width}`];
+  if (quality) {
+    params.push(`quality=${quality}`);
+  }
+  const paramsString = params.join(",");
+  return `/cdn-cgi/image/${paramsString}/${normalizeSrc(src)}`;
+}
+```
+
+You will then need to update your app configuration to use this loader:
+
+```ts
+// next.config.ts
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  // ...
+  images: {
+    loader: "custom",
+    loaderFile: "./image-loader.ts",
+  },
+};
+
+export default nextConfig;
+```
+
+<Callout type="info">
+  Images using the cloudflare loader are served directly without going through the middleware.
+</Callout>
+
+See more details in the [Cloudfare Images documentation](https://developers.cloudflare.com/images/transform-images/integrate-with-frameworks/).
diff --git a/pages/cloudflare/index.mdx b/pages/cloudflare/index.mdx
index 8069067..205b64f 100644
--- a/pages/cloudflare/index.mdx
+++ b/pages/cloudflare/index.mdx
@@ -50,7 +50,7 @@ We will update the list as we progress towards releasing 1.0.
 - [x] [Static Site Generation (SSG)](https://nextjs.org/docs/app/building-your-application/rendering/server-components#static-rendering-default)
 - [x] [Server-Side Rendering (SSR)](https://nextjs.org/docs/app/building-your-application/rendering/server-components)
 - [x] [Middleware](https://nextjs.org/docs/app/building-your-application/routing/middleware)
-- [x] [Image optimization](https://nextjs.org/docs/app/building-your-application/optimizing/images) (you can integrate Cloudflare Images with Next.js by following [this guide](https://developers.cloudflare.com/images/transform-images/integrate-with-frameworks/))
+- [x] [Image optimization](https://nextjs.org/docs/app/building-your-application/optimizing/images) (See [this guide](/cloudflare/howtos/image) to configure [Cloudfare Images](https://developers.cloudflare.com/images/))
 - [x] [Partial Prerendering (PPR)](https://nextjs.org/docs/app/building-your-application/rendering/partial-prerendering)
 - [x] [Pages Router](https://nextjs.org/docs/pages)
 - [x] [Incremental Static Regeneration (ISR)](https://nextjs.org/docs/app/building-your-application/data-fetching/incremental-static-regeneration) <sup>1</sup>