README.md

eHalalan

eHalalan is a decentralized election system using blockchain.

Project Structure

apps/
├── smart-contracts/  # Solidity smart contracts managed with Hardhat
├── web/              # Next.js frontend

Tech Stack

• Smart Contracts:
  • Solidity
  • Hardhat
• Frontend:
  • Next.js
  • Tailwind CSS
  • shadcn components
• Backend:
  • Firebase
• Wallet & Web3 Integration:
  • MetaMask
  • ethers.js

Installation

Clone the repository and install dependencies:

git clone https://github.com/eHalalan/ehalalan.git
cd ehalalan

Smart Contracts Setup

cd apps/smart-contracts
npm install
npx hardhat compile

Frontend Setup

cd ../web
npm install
npm run dev

Usage

Smart Contracts

cd apps/smart-contracts
npx hardhat node
npx hardhat run scripts/deploy.ts --network localhost

Frontend

cd apps/web
npm run dev

If using VS Code, you can run the tasks via the command palette or Ctrl + Shift + B.

Contributing

1. Clone the repository.
2. Create a new branch.
3. Make changes and commit.
4. Submit a pull request.