jotagep / harmony-dapp-template

🧰 All-in-one forkable Harmony dev stack to build your dapp
MIT License
10 stars 9 forks source link
blockchain dapp hardhat harmony-one

header

example workflow

🧰 Harmony Dapp Template

All-in-one forkable dev stack to build your dapp in Harmony πŸš€

πŸ§ͺ Play with contracts and frontend to see how Harmony One works:

image

🚨 How to start use Harmony-dapp-template to create your project on harmony

Video tutorial with generator βš™οΈ NEW -> Youtube

Video tutorial manual -> Youtube

🚴 Quick Start

Prerequisites


Clone/fork 🧰 Harmony Dapp Template:

git clone https://github.com/jotagep/harmony-dapp-template

or

Use our harmony dapp generator βš™οΈ NEW:

# Install yo and our generator globally
npm install -g yo
npm install -g generator-harmony-dapp

# Create a folder & use harmony dapp generator
mkdir harmony-dapp-template
cd harmony-dapp-template
yo harmony-dapp

Check generator's full documentation


Once you have repository downloaded, you can follow Auto init or Manual init tutorial

Auto init

This script build & start docker harmony localnet and deploy your contract with Hot reloading, all-in-one command πŸ“‘.

cd harmony-dapp-template
yarn autoinit

Manual init

Install dependencies and build & start your ⛓️ Harmony Localnet Node:

cd harmony-dapp-template
yarn install
yarn localnet:build
yarn localnet:start

Open a second terminal window, πŸ›° deploy your contract:

cd harmony-dapp-template
yarn deploy
# Localnet by default
# But you can deploy in another network: yarn deploy:testnet // yarn deploy:mainnet

or if you want to have Hot Reloading to deploy your contracts on live:

cd harmony-dapp-template
yarn deploy:watch

Finally

Open another terminal window, start your πŸ“± frontend:

cd harmony-dapp-template
yarn start
# Start your frontend in localhost:3000

πŸ” Edit your smart contract Donation.sol in packages/hardhat/contracts

πŸ“ Edit your frontend App.jsx in packages/frontend/src

πŸ’Ό Edit your deployment scripts in packages/hardhat/deploy

πŸ“± Open http://localhost:3000 to see the app


Start to play with your dapp πŸ₯³ !!

To get 100 ONEs in your wallet on localnet

cd harmony-dapp-template
yarn fund 'YOUR_WALLET_ADDRESS'
# Example yarn fund one1hru2uxps5z76atvc666v4yqp8r3894wh9uf7qn

Now you have all you need to interact with example dapp, but that's not all. We decide to add more tasks to Hardhat to simplify your life.

cd harmony-dapp-template
yarn hardhat [GLOBAL_OPTION] [AVALIABLE_TASK]
# Example: yarn hardhat clean

screenshot

To see this info in your terminal:

yarn hardhat --help

πŸ”› Deploy in another network

When you want to deploy your contracts in another network: Testnet or Mainnet. You should create .env file based on .example.env and set your private keys.

env

β›΅ Ship it!

Once you have your project done, you can deployed to live

cd harmony-dapp-template
yarn surge
# By default your frontend is build on localnet network
# You can deploy testnet or mainnet
# Example: yarn surge:testnet

πŸ“š Extra Documentation


Checklist for Gitcoin Bountie

⏱️ Coming soon...


πŸ™ Inspired by scaffold-eth - Austin Griffith genius 🧞