Web3 sample app

Requirements

• curl
• nvm

  nvm install v18.10.0
  nvm use v18.10.0
  nvm alias default v18.10.0
  npm install npm --global

• pnpm

  npm install -g pnpm

• kind >=0.16.0
• kubectl

Features & Plugins

• React, TypeScript, Vite
• ethers.js
• i18n, store - works out-of-box
• TailwindCSS - CSS framework for rapid UI development

Help

$ make help

Usage: make COMMAND
Commands :
help          - List available tasks
clean         - Cleanup
install       - Install NodeJS dependencies
build         - Build
upgrade       - Upgrade dependencies
run           - Run
image-build   - Build a Docker image
image-run     - Run a Docker image
image-stop    - Stop a Docker image
check-version - Ensure VERSION variable is set
release       - Create and push a new tag
kind-deploy   - Deploy to a local KinD cluster
kind-undeploy - Undeploy from a local KinD cluster
kind-redeploy - Redeploy to a local KinD cluster

Usage

make run

Kubernetes deployment

Deploy using docker image from public repository

Deploy workload

kubectl apply -f ./k8s --namespace=web3 --validate=false

Get workload's IP

service_ip=$(kubectl get services web3-sample-app -n web3 -o jsonpath="{.status.loadBalancer.ingress[0].ip}")
xdg-open "http://${service_ip}:8080" > /dev/null 2>&1

Delete workload

kubectl delete -f ./k8s --namespace=web3

Deploy to local Kind cluster

make kind-deploy

Undeploy from local Kind cluster

make kind-undeploy

Release

• Update field Version

  const Version = "vX.Y.Z"
  

• Run release target

  make release

Valid eth address to test:

0xeB2629a2734e272Bcc07BDA959863f316F4bD4Cf