🚀 Elite Hack 1.0 Hackathon Project 👨💻 Team: GenXCoders 🎯 Theme: Digital Civic Governance
In many rural and semi-urban areas, citizens still depend on manual and inefficient systems to report civic or infrastructure problems.
Common issues include:
- Citizens must physically visit government offices
- Complaints often go undocumented
- No transparent tracking system
- Field workers are not accountable
- Citizens rarely know who is handling their issue
- Poor internet connectivity prevents using complex digital systems
Examples of problems people face daily:
- 🚰 Water pipeline leaks
- ⚡ Electricity outages
- 🗑 Garbage accumulation
- 🛣 Broken roads
- 🏢 Delays in public services
These challenges lead to slow response times, lack of accountability, and poor governance transparency.
SevaLink is a community operations platform that connects citizens, administrators, and field workers into a single digital ecosystem.
The system enables a complete lifecycle for issue reporting and resolution.
✔ Report civic problems ✔ Upload photo evidence ✔ Track request status ✔ View assigned worker details
✔ Monitor all complaints in one dashboard ✔ Assign workers efficiently ✔ Track resolution progress ✔ Analyze issue trends and worker performance
✔ View assigned tasks ✔ Navigate to issue locations ✔ Upload proof of work ✔ Mark issues as resolved
- Email & mobile based registration
- Google OAuth login
- Role-based authentication (Citizen / Worker / Admin)
- Complaints visualized on OpenStreetMap
- Enables location-based issue monitoring
Workers can upload photo proof after completing tasks.
Admins can track:
- Issue categories
- Worker performance
- Resolution statistics
Designed for low digital literacy users
- Mobile-first interface
- Large buttons
- Minimal steps
- Report infrastructure problems
- Track complaint resolution
- Manage complaints
- Assign field workers
- Monitor performance
- Receive tasks
- Upload completion evidence
- Update status
✔ Improves transparency in public services ✔ Strengthens trust between citizens and authorities ✔ Empowers rural communities
✔ Reduces travel cost for citizens ✔ Improves worker efficiency
✔ Reduces paper-based complaint systems ✔ Faster sanitation and waste issue resolution
| Layer | Technology |
|---|---|
| Frontend | React.js, Vite, TailwindCSS |
| Routing | React Router |
| Backend | Node.js, Express.js |
| Database | MongoDB (Mongoose ORM) |
| Authentication | JWT, Google OAuth |
| File Upload | Multer |
| Nodemailer | |
| SMS | Fast2SMS |
| Maps | Leaflet (OpenStreetMap) |
| Offline Storage | IndexedDB |
1️⃣ Register / Login 2️⃣ Report civic issue 3️⃣ Upload image evidence 4️⃣ Track issue progress
1️⃣ View all complaints 2️⃣ Assign worker 3️⃣ Monitor progress 4️⃣ Analyze performance metrics
1️⃣ Worker login 2️⃣ View assigned tasks 3️⃣ Upload work proof 4️⃣ Mark task completed
| Feature | Traditional Systems | SevaLink |
|---|---|---|
| Online Complaint Tracking | ❌ | ✅ |
| Map Based Issue Monitoring | ❌ | ✅ |
| Worker Accountability | ❌ | ✅ |
| Real-time Status Updates | ❌ | ✅ |
| Data Analytics | ❌ | ✅ |
India has 600,000+ villages, many of which still use manual complaint systems.
SevaLink can scale through:
- Panchayat governance platforms
- Municipal complaint systems
- Government SaaS solutions
- CSR technology initiatives
(https://github.com/mrdeyroy/sevalink.git)
(https://sevalink-frontend.onrender.com)
Follow these instructions to run the project locally.
Make sure you have:
- Node.js (v18+)
- MongoDB (local or MongoDB Atlas)
Clone the repository:
git clone https://github.com/mrdeyroy/sevalink.git
cd sevalinkInstall dependencies:
# Install backend dependencies
cd server
npm install
# Install frontend dependencies
cd ../client
npm installCreate a .env file inside /server
Example:
PORT=5000
MONGO_URI=mongodb+srv://<username>:<password>@cluster0.mongodb.net/sevalink
JWT_SECRET=your_super_secret_key
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
CLIENT_URL=http://localhost:5173
EMAIL_USER=your_nodemailer_email@gmail.com
EMAIL_PASS=your_email_app_password
FAST2SMS_API_KEY=your_fast2sms_api_key
Run backend and frontend separately.
cd server
npm start
Backend runs on:
http://localhost:5000
cd client
npm run dev
Frontend runs on:
http://localhost:5173
By default, new users register as Citizen.
To create an Admin:
- Register normally
- Open MongoDB
- Find your user in
userscollection - Change role from:
"role": "citizen"
to
"role": "admin"
Admin can then create worker accounts.
Workers are created by Admin.
Admin provides:
- Name
- Mobile number
- Temporary password
Workers login via:
/worker-login
Workers must change their password during their first login.
We are passionate developers focused on building technology solutions for real societal problems.
SevaLink aims to create transparent, accessible, and efficient civic governance systems for rural communities.
To build the digital backbone of rural governance, enabling citizens to easily report and track civic issues while empowering administrators with real-time data and insights.
MIT License