VoteUp is a decentralized voting platform built on the Ethereum blockchain that supports end-to-end verifiable elections. It ensures transparency, integrity, and voter privacy through a commit-reveal voting scheme. The system supports role-based permissions (admin, voters, candidates), on-chain result validation, and real-time frontend interactions — all in a trustless, decentralized environment.

Watch the full demo on YouTube:

Click the thumbnail above or watch it here

• Features
• Tech Stack
• Architecture
• Smart Contract Overview
• Installation and Running Locally
• Usage Flow
• Commit-Reveal Voting Explained
• Benefits
• File Structure
• Contributing
• License
• Contact

• 📿 Candidate & Voter Registration Users can request registration; election admins must approve to ensure legitimacy.

• 🔐 End-to-End Verifiable Voting Uses a commit-reveal scheme to keep votes private and later verifiable.

• 🧠 Election Lifecycle Management Admins can create elections, approve users, start/end elections, and fetch results.

• 🔠 Responsive React Frontend Built with React, Tailwind, and Framer Motion for smooth UX.

• ⚡ Real-Time Feedback Users get live election updates, success/failure toasts, countdowns, and more.

• ⚙️ Automatic Smart Contract Deployment Each election triggers a fresh contract deployment on Sepolia via ethers.js.

Browser UI (React + Tailwind + Framer)
   |
   |---> Web3 Provider (MetaMask)
   |
   |---> Web3Context & Contract Utility Layer (ethers.js)
   |
Smart Contract Layer (Solidity on Sepolia)
   |
   |---> Voting.sol (deployed per election)

• Frontend: Fully interactive UI for elections, voting, results, and admin actions.
• Contract Deployment: Done dynamically from the frontend using a deploy function in contract.ts.
• Storage: Temporary frontend state stored using IndexedDB (dexie).
• Interaction: Ethers.js handles commitVote, revealVote, and other contract interactions.

File: contracts/Voting.sol

git clone https://github.com/Het2239/VoteUp.git
cd VoteUp

npm install

npm run dev

Navigate to: http://localhost:3000

📝 You do not need to manually deploy contracts. The app auto-deploys a new smart contract to Sepolia testnet whenever a new election is created. The actual port/URL may vary; check your terminal after starting the server.

• Admin creates an election via frontend.
• Contract is deployed to Sepolia dynamically.

• Users apply via the frontend.
• Admin views pending requests and approves them on-chain.

• Voter casts a hash of (candidateId + salt) using commitVote.

• Voter reveals original (candidateId, salt) using revealVote.
• Contract verifies: keccak256(candidateId + salt) === committedHash.

• After reveal deadline, results are computed and displayed.

• Frontend shows:

  • 🏆 Winner(s) (with tie handling)
  • 📊 Vote breakdown
  • ✅ Reveal status per voter

What is Commit-Reveal Voting?

Commit-reveal is a two-phase voting scheme:

1. Commit Phase: Voters submit a hashed version of their vote (typically hash(vote + secret)), committing to their choice without revealing it.
2. Reveal Phase: Voters later disclose their vote and secret. The system verifies that the original hash matches.

This ensures:

• Privacy: Votes remain hidden during the election.
• Verifiability: Everyone can later verify each vote.
• Fairness: No early reveals influence others.

• Votes are hidden during the commit phase.
• Prevents vote buying or coercion since votes aren’t visible.

• Each voter can verify their vote via their hash.
• Anyone can audit if results match committed and revealed votes.

• Elections aren’t controlled by a central authority.
• Contracts enforce rules in a censorship-resistant way.

• All votes are revealed at the same time, or none.
• Prevents influencing voters based on early disclosures.

• Gas-efficient: only a hash is stored during commit.
• Minimal on-chain data usage.
• No need to store full vote data on-chain.

⚠️ Requires users to interact twice (commit + reveal)

• Deterministic: Results are final once reveals are done.

• Robust: Cannot be taken down or altered.

• Graceful Failure Handling:

  • Votes not revealed can be skipped.
  • Reveal reminders and auto-enforced deadlines can help.

VoteUp delivers a secure, decentralized, and verifiable voting experience through commit-reveal logic.

It’s ideal for:

• DAOs
• Campus/University elections
• Local and community decision-making

VoteUp/
├── contracts/                  # Voting.sol smart contract
├── src/
│   ├── components/             # UI components (Cards, Modals, Voting UI)
│   ├── contexts/               # Web3 & Theme context
│   ├── utils/                  # Ethers interaction, deployment, vote logic
│   ├── App.tsx                 # Root React component
│   ├── main.tsx                # Entry point
│   └── index.css               # Global styles
├── public/
├── index.html                  # Base HTML
├── tailwind.config.js
├── vite.config.ts
├── tsconfig.json
├── package.json
└── README.md

We welcome contributions from the community! If you'd like to contribute:

1. Fork the repository.
2. Create a new branch.
3. Make your changes.
4. Submit a pull request with a clear description.

Whether it's bug fixes, feature additions, or documentation updates — all contributions are appreciated.

This project is licensed under the MIT License. See LICENSE for more details.

Created with ❤️ by Het Chavadiya

• 📧 Email: hetchavadiya@gmail.com
• 👩‍💻 LinkedIn: linkedin.com/in/hetchavadiya
• 💍 GitHub: @Het2239

If you use this project or find it helpful, feel free to ⭐ the repo!