diff --git a/MIGRATION_GUIDE.md b/MIGRATION_GUIDE.md
index 5bb6e10a..fbc85e49 100644
--- a/MIGRATION_GUIDE.md
+++ b/MIGRATION_GUIDE.md
@@ -50,5 +50,31 @@ Choose one of the following migration paths depending on your application:
     - Run `npx expo prebuild --clean` (any manual changes to Android or iOS folders will be lost)
     - Add the new callback URL to Auth0 dashboard
 - **If your project is built with Non Expo:**
+
   - To keep things as it is, set `useLegacyCallbackUrl` to true in `authorize` and `clearSession`
   - To migrate to new non-custom scheme flow, add the new callback URL to Auth0 dashboard
+  - Change the manifest placeholders in your app's build.gradle file (typically at android/app/build.gradle):
+
+  **Old**
+
+```
+  android {
+    defaultConfig {
+        manifestPlaceholders = [auth0Domain: "YOUR_AUTH0_DOMAIN", auth0Scheme: "${applicationId}"]
+    }
+    ...
+}
+```
+
+**New**
+
+Notice the new `.auth0` suffix in auth0Scheme:
+
+```
+android {
+    defaultConfig {
+        manifestPlaceholders = [auth0Domain: "YOUR_AUTH0_DOMAIN", auth0Scheme: "${applicationId}.auth0"]
+    }
+    ...
+}
+```
diff --git a/README.md b/README.md
index 1eb2fc6b..f8c35b35 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,11 @@
 
 📚 [Documentation](#documentation) • 🚀 [Getting Started](#getting-started) • ⏭️ [Next Steps](#next-steps) • ❓ [FAQs](https://github.com/auth0/react-native-auth0/blob/master/FAQ.md) • ❓ [Feedback](#feedback)
 
+### ⚠️ Important Migration Notice: v3.0.0
+
+We're excited to announce the release of react-native-auth0 v3.0.0! Please note that this update includes breaking changes that require your attention. To ensure a smooth transition, please review our
+👉 [Migration Guide](https://github.com/auth0/react-native-auth0/blob/master/MIGRATION_GUIDE.md) 👈 for detailed instructions on updating your integration.
+
 ## Documentation
 
 - [Quickstart](https://auth0.com/docs/quickstart/native/react-native/interactive)