AppKit

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

Dev setup

Create apps/laboratory/.env.local file using the template from apps/laboratory/.env.example
In each of the examples create .env.local file with following contents

VITE_PROJECT_ID="your_project_id"

Run pnpm watch to build and watch for file changes in a separate tab
Run gallery, laboratory or examples in a separate tab i.e. pnpm laboratory

Releasing new versions

Enter prelease mode [Optional]

If you need to release a canary/alpha/beta you need to enter prelease mode first

pnpm changeset:pre <release tag>

For example: pnpm changeset:pre a123bas2

Generate changeset

If you need to release a canary/alpha/beta you need to enter prelease mode first

pnpm changeset

For example: pnpm changeset:pre a123bas2

Steps

Run pnpm update and update dependencies
Run pnpm install and verify if everything still works correctly
Merge your feature branch into V4
Create a new branch from V4 and name it with the version tag
Run pnpm changeset and set new custom version, enter prelease mode first if you want to add a tag to the version.
Update version in ConstantsUtil in @web3modal/scaffold-utils to the correct version
Create a new PR with Release Notes and merge into V4
Checkout V4 and run pnpm publish:latest
Draft a new release in GitHub and create new tag
Click on Generate Change and only leave the link with difference. Paste in your changelog from PR.
Check Set as the last release and publish release.
Update Web3Modal for https://web3modal.com/ (https://github.com/WalletConnect/www-web3modal) and create a PR
Update Web3Modal for https://app.web3inbox.com (https://github.com/WalletConnect/web3inbox) and create a PR

Running tests

See <app/laboratory/tests/README.md>

CocosTechLabs/web3modal

📚 Documentation

🧪 Laboratory