VotePeace is an enterprise-grade, secure, and transparent electronic voting platform designed to streamline elections for organizations of all sizes. It ensures integrity, real-time analytics, and a seamless user experience for both voters and administrators.

VotePeace solves the challenge of manual, error-prone voting processes by providing a digital-first solution. It features a robust backend for secure vote processing and a modern, responsive frontend for an engaging voter experience.

• Security First: Encrypted vote storage and secure authentication.
• Real-Time Analytics: Instant visualization of election results.
• Cross-Platform: Optimized for web and mobile devices.
• Scalable Architecture: Modular design separating concern between client and server.

This repository uses a Monorepo structure to house both the server-side and client-side applications.

VotePeace/
├── VotePeace-Backend/   # Go (Fiber) + SQLite API Server
├── VotePeace-Frontend/  # React (Vite) + MUI Client Application
├── ARCHITECTURE.md      # System-wide Architecture Documentation
└── README.md            # You are here

To get the entire system running locally:

• Go 1.21+
• Node.js 20+
• Git

1. Clone the Repository:

   git clone https://github.com/MDF05/VotePeace.git
   cd VotePeace

2. Setup Backend:

   cd VotePeace-Backend
   go mod tidy
   go run main.go

   Server runs at http://localhost:3000

3. Setup Frontend (New Terminal):

   cd VotePeace-Frontend
   npm install
   npm run dev

   Client runs at http://localhost:5173

Detailed documentation for the entire platform:

We follow a strict Fork & Pull Request workflow.

1. Fork the repo.
2. Create a feature branch.
3. Commit changes (Conventional Commits).
4. Open a Pull Request against main.

See CONTRIBUTING.md for details.

Security is paramount. Please adhere to the policies outlined in SECURITY.md. Do not report vulnerabilities on public issues.

This project is licensed under the MIT License. See LICENSE.

Muhammad Dava Fahreza

• GitHub: @MDF05