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.
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!
Option | Values |
---|---|
theme | dark , light |
accentColor | blackWhite , blue , default , green , magenta , orange , teal |