A starter kit to create a fully onchain application with a progressive web app (PWA) mobile client. This shows up on a users mobile homescreen. With one command, get a:
- Mobile client synced to onchain state: The client syncs and reacts to onchain state updates out of the box using MUD's client and smart contract libraries
- Social onboarding: Simple & easy onboarding for users without wallets using Privy's embedded wallets
- PWA detection and installation: Detect a user's environment & guide them to install on mobile, and configure PWA settings however you want using Vite PWA for PWA configuration
This is a modification of MUD's starter template for progressive web apps.
Examples of onchain apps that use PWAs include friend.tech and words.art (no affiliation with this project).
This project uses pnpm workspaces. To install packages and run, simply run
pnpm install
pnpm dev
This will deploy smart contracts to a local chain and deploy the client. You can also deploy the contracts to the Lattice Testnet by running
cd packages/contracts && pnpm deploy:testnet
Then, make sure to set VITE_CHAIN_ID=4242 in packages/client/.env, and you have a PWA with synced onchain state deployed on testnet. It will even automagically drip funds (using Lattice's Faucet Service) to whichever wallet you connect with Privy, so you can submit transactions right away.
This starter kit uses Privy for social onboarding & creation of embedded wallets on users' devices. You will need a Privy App ID to get going. Grab one at privy.io
Set this App ID to the VITE_PRIVY_APP_ID field in the packages/client/.env environment. An example environment is provided.
If you'd like embedded wallet functionality, make sure the Create Embedded Wallet on User Login setting is enabled on your Privy dashboard.
This project uses MUD, a solidity library and associated set of client libraries, for smart contracts & client-side onchain state syncing. For more info on MUD, look at mud.dev
If you have questions, concerns, bug reports, etc, please file an issue in this repository's Issue Tracker.