From dcd46fdea7facfd7140338a7204b184ecf72a728 Mon Sep 17 00:00:00 2001
From: Kris Baumgartner <kjbaumgartner@gmail.com>
Date: Fri, 6 Dec 2024 11:59:38 -0500
Subject: [PATCH] chore: update docs for React 19 info

---
 package.json | 3 ++-
 readme.md    | 6 ++++++
 2 files changed, 8 insertions(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 2fbd6e9788..2807453e9c 100644
--- a/package.json
+++ b/package.json
@@ -88,5 +88,6 @@
     "ts-jest": "^27.1.4",
     "typescript": "^4.6.3"
   },
-  "dependencies": {}
+  "dependencies": {},
+  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
 }
diff --git a/readme.md b/readme.md
index a6d1a7d62b..1092c627f5 100644
--- a/readme.md
+++ b/readme.md
@@ -10,6 +10,12 @@
 
 <a href="https://docs.pmnd.rs/react-three-fiber/getting-started/examples"><img src="/docs/banner-r3f.jpg" /></a>
 
+> [!WARNING]  
+> R3F v8 is not compatible with React 19 or Next 15, which uses React 19. Use the R3F v9 RC instead which can be installed with `@react-three/fiber@rc`.
+
+> [!NOTE]  
+> While we work on R3F v9 you can track compatibility of different libraries and common workarounds [here](https://github.com/verekia/three-gpu-ecosystem-tests).
+
 react-three-fiber is a <a href="https://reactjs.org/docs/codebase-overview.html#renderers">React renderer</a> for threejs.
 
 Build your scene declaratively with re-usable, self-contained components that react to state, are readily interactive and can participate in React's ecosystem.