diff --git a/tutorial/0-overview.md b/tutorial/0-overview.md new file mode 100644 index 0000000..5b4ccc2 --- /dev/null +++ b/tutorial/0-overview.md @@ -0,0 +1,8 @@ +# Creating a custom ERC721 marketplace DApp + +## Intro +In this tutorial series, we'll explore how can we use Embark to simplify the development of DApps. We will use the EmbarkJS to store image files in IPFS, and create the required functionality to interact with contracts in the Ethereum Blockchain. + +In order for us to focus on these two aspects of DApp development, the code for the frontend is already created, and can be downloaded from our [repository](https://github.com/status-im/status-dapp-workshop-mexico) + +The Dapp we will build is an [ERC721](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md) Marketplace that will allow us to mint non fungible tokens, to buy and sell them. \ No newline at end of file diff --git a/tutorial/1-workspace.md b/tutorial/1-workspace.md new file mode 100644 index 0000000..d464061 --- /dev/null +++ b/tutorial/1-workspace.md @@ -0,0 +1,53 @@ +## Setting up the workspace + +Before starting, it's important to have setup correctly our workspace. You can follow the steps described in the [documentation](https://embark.status.im/docs/), since it will always be updated to reflect latest changes in the framework. If you already have Embark and its dependencies installed you can skip this step. + +At the moment of writing the tutorial, the commands I used on Ubuntu 18.04 were these. Some steps change depending on the operative system used (i.e. [node-gyp](https://github.com/nodejs/node-gyp)), as well as the versions of files. Please refer to Embark or any of the installed tools' documentation website for troubleshooting. + +### NodeJS 9.8.0 (lts) with nvm 0.33.11 +``` +curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash +bash .bashrc +nvm install --lts +``` +### Go-ethereum 1.8.11 +``` +sudo add-apt-repository -y ppa:ethereum/ethereum +sudo apt-get install ethereum +``` + +### IPFS 0.4.15 +``` +curl -O https://dist.ipfs.io/go-ipfs/v0.4.15/go-ipfs_v0.4.15_linux-amd64.tar.gz +tar xvfz go-ipfs_v0.4.15_linux-amd64.tar.gz +cd go-ipfs +sudo ./install.sh +ipfs init +``` + +### Tools and dependencies +``` +apt install python ganache-cli git build-essential +npm install node-gyp -g +``` + +### Embark +``` +npm install -g embark +``` + +After all thesese dependencies and embark are installed, proceed to fork/clone the dapp repository using + +``` +git clone https://github.com/status-im/status-dapp-workshop-mexico.git +``` +And proceed to install the npm packages this project uses + +``` +cd status-dapp-workshop-mexico +npm install +``` + +Once all the packages are installed, execute embark via `embark run` in the same directory. You should see the following screen: + +[IMAGE_HERE] \ No newline at end of file diff --git a/tutorial/2-minting-tokens.md b/tutorial/2-minting-tokens.md new file mode 100644 index 0000000..e69de29 diff --git a/tutorial/3-listing-buying-selling-tokens.md b/tutorial/3-listing-buying-selling-tokens.md new file mode 100644 index 0000000..e69de29 diff --git a/tutorial/4-deployment.md b/tutorial/4-deployment.md new file mode 100644 index 0000000..e69de29 diff --git a/tutorial/images/dashboard.png b/tutorial/images/dashboard.png new file mode 100644 index 0000000..9e593d5 Binary files /dev/null and b/tutorial/images/dashboard.png differ