https://github.com/thejasmeetsingh/voting-dapp

A decentralized voting application
https://github.com/thejasmeetsingh/voting-dapp

blockchain dapp ethereum hardhat ipfs metamask pinata-ipfs reactjs solidity tailwindcss web3 web3js

Last synced: 3 days ago
JSON representation

A decentralized voting application

• Host: GitHub
• URL: https://github.com/thejasmeetsingh/voting-dapp
• Owner: thejasmeetsingh
• Created: 2024-03-22T11:11:30.000Z (9 months ago)
• Default Branch: master
• Last Pushed: 2024-04-19T08:05:34.000Z (8 months ago)
• Last Synced: 2024-12-16T23:12:21.610Z (8 days ago)
• Topics: blockchain, dapp, ethereum, hardhat, ipfs, metamask, pinata-ipfs, reactjs, solidity, tailwindcss, web3, web3js
• Language: JavaScript
• Homepage:
• Size: 776 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Voting Dapp

![](./assets/image.png)

This decentralized voting app allows an admin to add political candidates with their name, slogan, and logo, and allows voters to vote for their preferred candidates. The application is built using ReactJS for the frontend, Solidity for smart contracts, Hardhat for development and testing of smart contracts, Metamask for wallet integration, and IPFS (Inter Planetary File System) via Pinata service for uploading candidate logos.

## Features

1. **Add Candidate:** Admins can add candidates with their name, slogan, and logo.

2. **Add Voter:** Admins can add voters to the system.

3. **Vote for a Candidate:** Voters can cast their votes for the candidate of their choice.

All actions, including adding candidates, voters, and voting, are performed on the blockchain to ensure transparency and security.

## Prerequisites

Before running the application, make sure you have the following prerequisites installed:

- Metamask extension installed on your browser.

- Install [Node.JS](https://nodejs.org/en) on your system.

## Steps to Run the Application

1. Clone the Repository.

2. Setup and Deploy Smart Contracts.

   - Navigate to the project directory and run the following commands:

     - `make compile`

     - `make node`

     - `make deploy`

   - These commands will compile the smart contracts, start a local blockchain node, and deploy the contracts on the local node.

3. Run the Front-End:

   - Navigate to the client folder using the command.

   - Install the required dependencies using `npm install`.

   - Once the dependencies are installed, start the frontend server using `npm run dev`.

   This will start the frontend application and open it in your default browser.