CivicPulse 🏛️
CivicPulse is India's open civic issue-tracking platform. Citizens report broken infrastructure, overflowing drains, failing hospitals, and systemic corruption — with photo/video evidence, real-time community chat, and public tracking until it's resolved.
What is CivicPulse?
CivicPulse bridges the gap between citizens and local government by making civic complaints visible, verifiable, and trackable. Every issue gets a unique ID, a public URL, and a live status — so nothing disappears into a helpline void.
Key Features
| Feature | Description |
|---|---|
| 📋 Issue Reporting | File issues with photos, videos, and GPS location |
| 📍 City Tracking | Browse issues by city, category, and status |
| 📍 Near Me Sort | Location-based browsing with distance badges and Haversine proximity |
| 💬 Real-time Chat | Community discussion on every issue via WebSocket |
| ⭐ Contributor Scores | Civic contribution scoring with badges and leaderboard |
| 🚩 Flagging | Flag inappropriate images/videos and issues (separate from upvoting) |
| 🤝 Community Events | Organize and join civic action events |
| 🐦 X/Twitter Feed | Pull real civic complaints from social media |
| 🔌 Public API | Full REST API for integrations and third-party apps |
Tech Stack
- Frontend: React 19, Vite 7 — single-file component architecture
- Backend: Node.js, Express, Socket.IO — REST + WebSocket
- Database: AWS DynamoDB with GSIs for city/category/status queries
- Storage: AWS S3 with presigned URLs for media uploads
- Auth: JWT (HS256, 15 min) + httpOnly refresh token cookie (7 days)
- Docs: Docusaurus 3
Quick Links
- Getting Started — run locally in 5 minutes
- Architecture — system design overview
- API Reference — full REST API docs
- Scoring Algorithm — how contributor scores work
- Deployment — AWS production setup
- Project Plan — 67 features tracked with mock data labels
- Roadmap — upcoming features, mobile app, growth plan
- Building with Claude — full prompt-by-prompt build guide for students