From 2ff3eab27782e2a68c32509934b4e8f4385b1241 Mon Sep 17 00:00:00 2001
From: Alem Tuzlak <t.zlak@hotmail.com>
Date: Wed, 1 Oct 2025 15:59:25 +0200
Subject: [PATCH] chore: update migration docs for next/image

---
 .../framework/react/migrate-from-next-js.md   | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/start/framework/react/migrate-from-next-js.md b/docs/start/framework/react/migrate-from-next-js.md
index ad2b1cecaa7..250e4d90ea4 100644
--- a/docs/start/framework/react/migrate-from-next-js.md
+++ b/docs/start/framework/react/migrate-from-next-js.md
@@ -304,6 +304,29 @@ function Component() {
 
 Learn more about the [Links](/router/latest/docs/framework/react/guide/navigation#link-component).
 
+### Images
+
+Next.js uses the `next/image` component for optimized images. In TanStack Start, you can use the package called [Unpic](https://unpic.pics/) for similar functionality
+and almost a drop-in replacement.
+
+```tsx
+import Image from "next/image" // [!code --]
+import { Image } from "@unpic/react"; // [!code ++]
+function Component() {
+  return (
+    <Image
+      src="/path/to/image.jpg"
+      alt="Description"
+      width="600" // [!code --]
+      height="400" // [!code --]
+      width={600} // [!code ++]
+      height={400} // [!code ++]
+    />
+  )
+}
+```
+
+
 ### Server ~Actions~ Functions
 
 ```tsx