Getting started

Getting started

Prerequisites

  1. git (download (opens in a new tab))
  2. foundry (forge, anvil, cast) (download (opens in a new tab), make sure to foundryup at least once)
  3. node.js (v17+) (download (opens in a new tab))
  4. pnpm (npm install pnpm --global after installing node)

Setup

Most projects in MUD are started by running pnpm create mud <project name>, but for this tutorial we've included some initial code to get you up and running quicker. This includes React components and base TailwindCSS styles.

To get started you can fork or clone from the Emojimon starter kit repo (opens in a new tab) or use the command below.

git clone https://github.com/latticexyz/emojimon.git

Afterwards, run the following commands to install the dependencies and start up MUD's services (anvil node, contracts deployer, and client):

cd emojimon && pnpm install
pnpm run dev

If all went well you should see this in your command line.

A successful MUD deployment

After deployment is successful, pop over to http://localhost:3000 (opens in a new tab) and checkout your live app. At this point you can open up your code editor and get started!