// the find
Uniswap/web3-react
A simple, maximally extensible, dependency minimized framework for building modern Ethereum dApps
web3-react is a React connector framework for Ethereum dApps, giving you a unified hook interface across MetaMask, WalletConnect, Coinbase Wallet, and others. It's the library Uniswap itself uses, which tells you something about its production pedigree. Aimed at React developers building multi-wallet dApps who don't want to hand-roll connection state management.
The per-connector state model in v8 is a genuine improvement over v6's global singleton — you can have multiple connectors active simultaneously without juggling a single active provider. Peer-dependency design for connector-specific packages means you control the version of @walletconnect/ethereum-provider yourself, which matters when WalletConnect ships breaking changes. The monorepo structure lets you install only the connectors you actually need rather than pulling in the whole kitchen sink. Test coverage exists across the core packages and connectors, which is more than most wallet libraries bother with.
Still in beta as of the last push in August 2024, and activity has gone quiet — the README admits documentation is sparse and points you at TSDoc and source code as the primary references, which is a red flag for a library with this many moving parts. The ecosystem has largely moved toward wagmi, which has more active maintenance, better docs, and viem integration; choosing web3-react today means betting on a library Uniswap may quietly deprecate. No support for account abstraction or ERC-4337 wallets, which is increasingly a gap as smart contract wallets go mainstream. The upgrade path from v6 to v8 is non-trivial despite the README's optimism about it being a near drop-in replacement.