Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bruk19/votingsystem-frontend


https://github.com/bruk19/votingsystem-frontend

Last synced: 2 days ago
JSON representation

Awesome Lists containing this project

README 

        
# Decentralized Voting Application



> This is a decentralized voting application built with Next.js, React, and Solidity smart contracts. It allows users to create voting systems, cast votes, and view voting results in a transparent and secure manner using blockchain technology.



## Features

- Connect MetaMask wallet to interact with the application

- Create voting systems by specifying a vote name, candidate names, and voting duration

- Cast votes for candidates in active voting systems

- View a list of all created voting systems

- View voting results, including the number of votes for each candidate

- See the list of voter addresses for each voting system

- Check the remaining voting time for active voting systems



## Technologies Used

#### Frontend:

Next.js 13 (with app directory)

React 18

TypeScript

Tailwind CSS for styling



#### Backend:

Solidity for smart contracts

Ethers.js for interacting with Ethereum blockchain

Web3.js for additional Ethereum interactions



#### Development Tools:

Hardhat (assumed, for smart contract development and testing)



## Live Demo ()



[Live Demo Link](https://votingsystem-frontend.vercel.app/)



## Prerequisites



- Node.js (version 14 or later recommended)

- MetaMask browser extension

- Basic understanding of React, Next.js, and Ethereum blockchain



## Getting Started

1. Clone the repository:

Copy codegit clone [email protected]:bruk19/votingsystem-frontend.git

cd votingsystem-frontend



2. Install dependencies:

Copy code npm install

# or

yarn install



3. Set up environment variables:



Create a .env.local file in the root directory.

Add the following variables:

Copy codeNEXT_PUBLIC_CONTRACT_ADDRESS=your_contract_address

Replace your_contract_address with the deployed Voting System smart contract address.



4. Run the development server:

Copy codenpm run dev

# or

yarn dev



5. Open http://localhost:3000 in your browser to see the application.



## Usage

1. Connect your MetaMask wallet to the application.

Create a new voting system:



2. Enter a unique vote name.

Add candidate names (comma-separated or press Enter after each name).

Set the voting duration in days.

Click "Create Voting System".



3. Cast your vote:

Enter the vote name you want to participate in.

Enter the name of the candidate you want to vote for.

Click "Vote".



4. View voting results:

Click on a vote name in the "List of votes" section.

View the remaining voting time, voter addresses, and vote counts for each candidate.



## Smart Contract

The application interacts with a Solidity smart contract named VotingSystem. The contract's ABI and address are imported from the constants/voting.ts file. Make sure your smart contract is deployed on a compatible Ethereum network (e.g., Sepolia testnet) and update the contract address in the .env.local file.



### Prerequisites

- Have a computer and internet connection

- Have a basic knowledge of TypeScript

- Have a basic knowledge of Solidity

- Have a general understanding of what testing is

- Have visual-studio code or any other code editor installed on your computer.



### Setup

- Open your terminal in the folder where you want to have the project and run `git clone [email protected]:bruk19/Voting-System-Smart-Contract.git` to clone the project.

- Run `Voting-System-Smart-Contract` to move to the project directory.



### 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.



### License

This project is open-source and available under the MIT License.



### Acknowledgements

- The Ethereum community for providing tools and resources.

- Next.js and React communities for the fantastic frameworks.



## Author

👤 **Bruk Teshome**



- GitHub: [@githubhandle](https://github.com/bruk19)

- Twitter: [@twitterhandle](https://twitter.com/Bruktesh)

- LinkedIn: [LinkedIn](https://linkedin.com/in/bruk-teshome)



Feel free to check the [issues page](https://github.com/bruk19/votingsystem-frontend/issues).



## Show your support



Give a ⭐️ if you like this project!



## 📝 License



This project is [MIT](./LICENSE) licensed.



_NOTE: we recommend using the [MIT license](https://choosealicense.com/licenses/mit/) - you can set it up quickly by [using templates available on GitHub](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/adding-a-license-to-a-repository). You can also use [any other license](https://choosealicense.com/licenses/) if you wish._