react-quick-start

MetaMask Embedded Wallets — React Quick Start

Minimal React + Vite example demonstrating MetaMask Embedded Wallets (powered by Web3Auth) with the pre-built modal UI on EVM chains. Uses the @web3auth/modal React SDK with built-in hooks and native Wagmi integration.

Prerequisites

• Node.js 20+
• npm
• A Client ID from the Dashboard

Setup

1. Clone the repository

git clone https://github.com/Web3Auth/web3auth-examples.git
cd web3auth-examples/quick-starts/react-quick-start

2. Install dependencies

npm install

3. Configure environment variables

cp .env.example .env

Edit .env and set your Client ID:

VITE_WEB3AUTH_CLIENT_ID=YOUR_CLIENT_ID

4. Run the application

npm run dev

Visit http://localhost:5173 in your browser.

Use Sapphire Devnet (the default) for local development. Sapphire Mainnet does not allow localhost.

Resources

• MetaMask Embedded Wallets Documentation
• React SDK
• Dashboard
• Community — Builder Hub

License

MIT