Looking for v1.x readme? It is available on V1 Branch

Web3Modal

Your on-ramp to web3 multichain. Web3Modal is a versatile library that makes it super easy to connect users with your Dapp and start interacting with the blockchain.

⚠️ v2 is in early alpha and we are continuously adding more features, examples and documentation. As of now we support use cases with react and evm chains. Support for more frameworks and chains is on the way.

Quick Start

Getting started with web3modal is as easy as installing few packages, one for your preferred front-end framework i.e. @web3modal/react and chain ecosystem you are working with i.e @web3modal/ethereum.

1. Obtain your WalletConnect projectId

Head over to cloud.walletconnect.com to sign up and generate your projectId, which will be required to allow interactions with our explorer api and v2 protocol sdk's in the future.

2. Follow instructions and examples for your favourite framework

• React Docs / React Example
• Vue Docs / Vue Example (coming soon)
• Angular Docs / Angular Example (coming soon)
• Vanilla JS Docs / Vanila JS Example (coming soon)

3. Familiarise yourself with each chain package that you intend to use

• @web3modal/ethereum - EVM chains
• @web3modal/solana - (coming soon)

4. Customise your modal!

Web3Modal exposes some config options that allow you to personalise it and make it fit in better with your dapp's ui. As of now supported config options are specified below, but more are on the way!