e-Vote is a secure, modern, and verifiable electronic voting platform purpose-built for academic institutions (configured for Cavendish University Uganda). It provides a tamper-proof voting experience with offline resilience and cryptographic verification.
- End-to-End Encryption: Ballots are cast securely and tied to specific authenticated student credentials.
- Double-Vote Prevention: Built-in Row Level Security (RLS) ensures that a student can only cast a single vote per election.
- Live Dashboard: Students can view active, upcoming, and closed elections in real-time.
- Institutional Authentication: Powered by Clerk, restricting and managing access securely.
- Admin Management: (In Progress) A dedicated panel for creating elections and registering candidates.
- Framework: Next.js 14 (App Router)
- Database: Supabase (PostgreSQL + RLS)
- Authentication: Clerk
- Styling: Custom CSS Modules & CSS Variables (
globals.css)
git clone <your-repo-url>
cd e-Votenpm installCreate a .env.local file in the root of the project and populate it using the .env.local.example template:
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...
CLERK_WEBHOOK_SECRET=whsec_...
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/dashboard
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/dashboard
NEXT_PUBLIC_SUPABASE_URL=https://...
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJ...
SUPABASE_SERVICE_ROLE_KEY=eyJ...npm run devOpen http://localhost:3000 with your browser to see the result.
The platform relies on four core tables in Supabase:
voters: Synchronized automatically with Clerk via Webhooks.elections: Tracks the status of elections (draft, live, closed).candidates: Associates candidates with specific elections.votes: Secure ledger recording encrypted ballot casts with unique constraint checks.