VoteFlow is a real-time polling platform built with the MERN stack (MongoDB, Express.js, React, Node.js). It allows users to create, share, and vote on polls with instant results visualization using charts and real-time updates via Socket.io.
- Existing polling tools lack real-time updates, making results feel static.
- Users need a simple and user-friendly way to create and share polls.
- Free tools often lack QR code integration and data analytics.
| Goal | Objective |
|---|---|
| Real-Time Engagement | Instant vote updates for all users |
| Ease of Use | Create and share polls with minimal effort |
| Accessibility | Mobile-first design with QR code sharing |
| Data Insights | Visualize results with charts and basic analytics |
| Feature | Description |
|---|---|
| Poll Creation | Add questions, options, and configure poll settings |
| Real-Time Voting | Live vote updates with Socket.io |
| QR Code Sharing | Easily share polls with generated QR codes |
| Chart Visualizations | See results in Pie/Bar charts (Chart.js) |
| Feature | Description |
|---|---|
| User Authentication | JWT-based login/signup |
| Time-Bound Polls | Automatically close polls after a deadline |
| Multiple-Choice Polls | Allow users to select multiple options |
| Layer | Technology |
|---|---|
| Frontend | React.js, Chart.js, qrcode.react, Socket.io-client |
| Styling | CSS Modules, Flexbox/Grid |
| Backend | Node.js, Express.js, Socket.io |
| Database | MongoDB (Mongoose) |
| Auth | JWT + Bcrypt |
| Deployment | Frontend: Netlify/Vercel, Backend: Render |
| Endpoint | Method | Description |
|---|---|---|
/api/polls |
POST | Create a new poll |
/api/polls/:id |
GET | Fetch poll data |
/api/polls/vote |
PUT | Submit a vote |
🚀 Steps to Run Locally
git clone https://github.com/MAT1018/VoteFlow.git cd VoteFlow
cd frontend
npm install
npm start