AI-powered civic issue reporting and community-driven governance platform that helps citizens report, discover, validate, prioritize, and track public infrastructure issues in real time.
Deployment: [https://civic-fix-ai-eight.vercel.app/]
CivicFix AI is a modern civic engagement platform that bridges the gap between citizens and municipal authorities.
Citizens can report civic infrastructure issues such as:
- Potholes
- Garbage accumulation
- Drainage problems
- Streetlight failures
- Water leakage
- Road damage
- Public infrastructure defects
The platform uses AI-powered image verification, location intelligence, and community participation to ensure complaints are authentic, properly categorized, and prioritized based on real-world impact.
Before a complaint is accepted:
-
AI validates uploaded images
-
Detects whether the image depicts a real civic issue
-
Rejects irrelevant images (anime, screenshots, memes, pets, landscapes, etc.)
-
Validates image-description consistency
-
Auto-generates:
- Category
- Severity
- Confidence score
- Tags
✅ Real pothole image + pothole description → Accepted
❌ Batman image + pothole description → Rejected
❌ Pothole image + "Street Light Issue" description → Rejected
Guided multi-step workflow:
Upload evidence photo
Select location
- Current location
- Map picker
- Manual map selection
Describe issue
Review & Submit
Explore civic issues across the city using an interactive map.
Features:
- Complaint markers
- Nearby issues
- Search locations
- Location-based discovery
- Complaint clustering
- Live community feed
- Map-driven complaint exploration
Citizens can discover issues using:
Issues within a configurable radius
Issues in a specific ward
Issues reported across the city
Complete public issue feed
Instead of duplicate reporting:
Citizens can:
- Support existing complaints
- Increase issue visibility
- Help authorities prioritize problems
Benefits:
- Reduced duplicate reports
- Better prioritization
- Stronger community engagement
Track complaints through every stage:
Complaint successfully reported
Authority reviewing complaint
Work initiated
Issue fixed
Dedicated dashboard for municipal authorities.
Capabilities:
- View ward-specific complaints
- Filter by category
- Manage complaint status
- Prioritize high-impact issues
- Monitor community support
- Track resolution progress
- Email / Password Login
- Google OAuth Login
- Google OAuth Signup
- Secure Authority Login
- Role-Based Access Control
- JWT Authentication
- Protected Routes
- Role Guards
- Password Hashing (bcrypt)
Optimized for:
- Desktop
- Tablet
- Mobile
- Dark modern interface
- Multi-step reporting wizard
- Interactive maps
- Real-time feedback
- Accessible navigation
- Consistent design system
- React 19
- Vite
- Tailwind CSS
- Zustand
- Axios
- React Router
- React Hot Toast
- Recharts
- Lucide React
- Leaflet
- React Leaflet
- Google OAuth
- Node.js
- Express.js
- MongoDB
- Mongoose
- JWT
- bcrypt
- Cloudinary
- Multer
- Nodemailer
- OpenAI Vision API
- UUID
CivicFix AI leverages multimodal AI for civic issue validation.
- Civic image classification
- Image authenticity verification
- Image-description matching
- Auto categorization
- Severity assessment
- Confidence scoring
- Automated tagging
Secure social authentication
Image storage and optimization
AI-powered civic issue validation
Interactive mapping and location services
Insert your architecture diagram here.
Frontend (React)
│
▼
Backend API (Express)
│
┌────┼────┐
▼ ▼ ▼
MongoDB Cloudinary OpenAI
- Node.js 18+
- MongoDB
- Cloudinary Account
- OpenAI API Key
- Google OAuth Credentials
git clone https://github.com/rudraksh-mall/CivicFix.git
cd CivicFix
# Backend
cd backend
npm install
npm run dev
# Frontend
cd frontend
npm install
npm run dev