README.md

Blockchain Full-Stack App

Structure

blockchain-fullstack/
├── frontend/     # React + Vite + Tailwind + Ethers.js + Wagmi
├── backend/      # Express + MongoDB + Mongoose + Web3.js
└── contracts/    # Hardhat + OpenZeppelin + Ethers.js

Prerequisites

• Node.js LTS (https://nodejs.org)
• Git (https://git-scm.com)
• MongoDB (https://www.mongodb.com/try/download/community)
• MetaMask browser extension

Setup

Frontend

cd frontend
npm install
npm run dev

Backend

cd backend
cp .env.example .env   # fill in your values
npm install
npm run dev

Contracts

cd contracts
cp .env.example .env   # fill in your values
npm install
npx hardhat compile
npx hardhat test
npx hardhat node       # local blockchain
npm run deploy:local

VS Code Extensions (install manually)

• Solidity (NomicFoundation.hardhat-solidity)
• ESLint (dbaeumer.vscode-eslint)
• Prettier (esbenp.prettier-vscode)
• Tailwind CSS IntelliSense (bradlc.vscode-tailwindcss)
• GitLens (eamodio.gitlens)
• Thunder Client (rangav.vscode-thunder-client)