address feedback

Author: alexandratran

sdk/index.md

@@ -9,8 +9,8 @@ import CardList from '@site/src/components/CardList'
 
 # Seamlessly connect to MetaMask using the SDK
 
-MetaMask SDK is a toolkit that enables a fast, reliable, and seamless connection from your dapp to the MetaMask extension and MetaMask Mobile.
-With the SDK, you can easily onboard users and interact with their accounts on desktop or mobile, across all EVM L1/L2 networks.
+MetaMask SDK enables a fast, reliable, and seamless connection from your dapp to the MetaMask extension and MetaMask Mobile.
+With the SDK, you can easily onboard users and interact with their accounts on desktop or mobile, across all EVM networks.
 
 <p align="center">
   <Button
@@ -25,6 +25,18 @@ With the SDK, you can easily onboard users and interact with their accounts on d
   />
 </p>
 
+## Why use the SDK?
+
+MetaMask SDK gives your dapp a powerful upgrade:
+
+- **Cross-platform, cross-browser support** - One integration covers both desktop and mobile, all major browsers, and the MetaMask Mobile app—streamlining your user onboarding and eliminating edge cases.
+- **Mobile connection that just works** - Say goodbye to clunky "open in in-app browser" flows.
+  The SDK enables a native connection from any mobile browser (Safari, Chrome, etc.) directly to MetaMask Mobile, using secure deeplinking and session management.
+- **Production-ready, battle-tested** - MetaMask SDK is used in high-volume dapps across DeFi, NFTs, gaming, and more—ensuring stability, speed, and a smooth developer experience.
+- **Multichain-ready by design** - Today, the SDK supports all EVM networks.
+  Coming soon: Seamless connection to non-EVM chains like Solana and Bitcoin.
+  Futureproof your dapp with a single integration.
+
 ## Supported platforms and libraries
 
 You can get started with the SDK on the following dapp platforms or third-party libraries:
@@ -56,30 +68,12 @@ You can get started with the SDK on the following dapp platforms or third-party
       title: 'React Native',
       description: 'Set up the SDK in a React Native or Expo dapp.',
     },
-    {
-      href: 'https://docs.reown.com/appkit/overview',
-      title: 'Reown AppKit',
-      description: 'Use SDK features with Reown AppKit.',
-      buttonIcon: 'external-arrow',
-    },
-    {
-      href: 'https://www.rainbowkit.com',
-      title: 'RainbowKit',
-      description: 'Use SDK features with RainbowKit.',
-      buttonIcon: 'external-arrow',
-    },
     {
       href: 'https://onboard.blocknative.com',
       title: 'Web3-Onboard',
       description: 'Use SDK features with Web3-Onboard.',
       buttonIcon: 'external-arrow',
-    },
-    {
-      href: 'https://docs.family.co/connectkit',
-      title: 'ConnectKit',
-      description: 'Use SDK features with ConnectKit.',
-      buttonIcon: 'external-arrow',
-    },
+    }
   ]}
 />
 

wallet/concepts/wallet-api.md

@@ -27,7 +27,7 @@ MetaMask supports [EIP-6963](https://eips.ethereum.org/EIPS/eip-6963), which int
 alternative wallet detection mechanism to the `window.ethereum` injected provider.
 This alternative mechanism enables dapps to support [wallet interoperability](wallet-interoperability.md)
 by discovering multiple injected wallet providers in a user's browser.
-We recommend [using this mechanism to connect to MetaMask](../how-to/connect.md).
+We recommend [using this mechanism to connect to MetaMask](../how-to/connect-extension.md).
 
 You can access the provider API using the selected EIP-6963 provider object.
 Throughout this documentation, we refer to the selected provider using `provider`.

wallet/concepts/wallet-interoperability.md

@@ -26,14 +26,14 @@ provided from each installed wallet:
   </video>
 </p>
 
-You can [connect to MetaMask using EIP-6963](../how-to/connect.md) and see the
+You can [connect to MetaMask using EIP-6963](../how-to/connect-extension.md) and see the
 [EIP-6963 Vite React + TypeScript demo](https://github.com/MetaMask/vite-react-ts-eip-6963/tree/main)
 for more information.
 
 ## EIP-6963 interfaces
 
 Wallets that support EIP-6963 implement and expose the following standardized interfaces.
-When [connecting to MetaMask using EIP-6963](../how-to/connect.md), it's important to review
+When [connecting to MetaMask using EIP-6963](../how-to/connect-extension.md), it's important to review
 and understand these interfaces.
 
 ### Provider info

wallet/how-to/access-accounts.md

@@ -31,7 +31,7 @@ You can also access users' accounts on some [non-EVM networks](/wallet/how-to/us
 
 :::caution Important
 This section describes how to create a single connect button.
-When connecting to multiple wallets, use the [Connect to MetaMask](connect.md) guide to create
+When connecting to multiple wallets, use the [Connect to the MetaMask extension](connect-extension.md) guide to create
 multiple connect buttons.
 :::
 

wallet/index.md

@@ -25,7 +25,7 @@ interact with users' EVM accounts, and implements standard interfaces like
 
 MetaMask also supports non-EVM networks, including native support for [Solana](how-to/use-non-evm-networks/solana.md).
 
-[Get started by connecting to MetaMask.](how-to/connect.md)
+[Get started with the Wallet API.](how-to/connect-extension.md)
 
 ## Wallet API vs. SDK
 

wallet/reference/provider-api.md

@@ -13,7 +13,7 @@ MetaMask supports [EIP-6963](https://eips.ethereum.org/EIPS/eip-6963), which int
 alternative wallet detection mechanism to the `window.ethereum` injected provider.
 This alternative mechanism enables dapps to support [wallet interoperability](../concepts/wallet-interoperability.md)
 by discovering multiple injected wallet providers in a user's browser.
-We recommend [using this mechanism to connect to MetaMask](../how-to/connect.md).
+We recommend [using this mechanism to connect to MetaMask](../how-to/connect-extension.md).
 
 You can access the provider API using the selected EIP-6963 provider object.
 Throughout this documentation, we refer to the selected provider using `provider`.

wallet/tutorials/javascript-dapp-simple.md

@@ -9,7 +9,7 @@ It demonstrates the basics of connecting to MetaMask: detecting the MetaMask pro
 
 :::caution Learning tutorial
 This tutorial is for educational purposes and connects to MetaMask using the legacy provider object, `window.ethereum`, for the sake of simplicity.
-For deployment in a production environment, we recommend [connecting to MetaMask using EIP-6963](../how-to/connect.md) instead.
+For deployment in a production environment, we recommend [connecting to MetaMask using EIP-6963](../how-to/connect-extension.md) instead.
 
 [EIP-6963](https://eips.ethereum.org/EIPS/eip-6963) introduces an alternative wallet detection mechanism to the `window.ethereum` provider, and enables dapps to support [wallet interoperability](../concepts/wallet-interoperability.md).
 
@@ -86,7 +86,7 @@ Update `index.html` to include the script:
 
 :::caution
 The `@metamask/detect-provider` module is deprecated, and is only used here for educational purposes.
-In production environments, we recommend [connecting to MetaMask using EIP-6963](../how-to/connect.md).
+In production environments, we recommend [connecting to MetaMask using EIP-6963](../how-to/connect-extension.md).
 :::
 
 Install the `@metamask/detect-provider` module in your project directory: