diff --git a/src/content/docs/en/guides/integrations-guide/cloudflare.mdx b/src/content/docs/en/guides/integrations-guide/cloudflare.mdx
index 2d3b7b39f6513..d474397954731 100644
--- a/src/content/docs/en/guides/integrations-guide/cloudflare.mdx
+++ b/src/content/docs/en/guides/integrations-guide/cloudflare.mdx
@@ -432,6 +432,22 @@ export default defineConfig({
 
 Astro 6 brings significant improvements to the Cloudflare development experience and requires `@astrojs/cloudflare` v13 or later. Now, `astro dev` uses Cloudflare's Vite plugin and `workerd` runtime to closely mirror production behavior.
 
+:::note[Conflicting Vite versions]
+Astro is not yet compatible with Vite 8. If you encounter issues in your project not addressed in the following sections during the upgrade, it may be due to different dependencies that pull both Vite 7 and Vite 8.
+
+You can work around this issue by defining an `overrides` field in your `package.json` file:
+
+```json
+{
+  "name": "my-astro-app",
+  ...
+  "overrides": {
+    "vite": "^7.3.1" // Pins Vite to a version supported by Astro
+  }
+}
+```
+:::
+
 <ReadMore>See [the Astro 6 upgrade guide](/en/guides/upgrade-to/v6/) for full instructions on upgrading Astro itself.</ReadMore>
 
 ### Development server now uses workerd