Empowering Citizens, Enabling Governance. A full-stack, real-time ecosystem connecting citizens directly with municipal authorities for rapid grievance resolution.
⚠️ Note: The backend is hosted on a free instance. It may take 50-60 seconds to wake up for the first request. Please be patient!
- 💻 Admin Panel: https://citizenconnect-admin-panel.vercel.app
- 📖 API Documentation: https://citizenconnect-zbfh.onrender.com/api-docs
- ⚙️ Backend API: https://citizenconnect-zbfh.onrender.com
CitizenConnect was architected with speed and scalability as the primary goals. We moved beyond traditional request-response cycles to build a truly live system.
- 🚀 Blazing Fast Load Times: The Admin Panel (Vite) renders the dashboard in < 1.5 seconds.
- ⚡ Optimized Backend: API response latency is consistently < 100ms thanks to optimized Prisma queries and connection pooling.
- 🔄 0.5s Real-Time Sync: When an admin updates a status, the citizen's mobile app reflects the change in under 1 second via WebSocket events—no pull-to-refresh needed.
- 📱 Seamless Mobile Experience: The Flutter app maintains 60 FPS performance even while rendering complex interactive heatmaps.
- 📸 Rapid Media Handling: Image uploads and processing via Cloudinary are optimized to complete in 2-3 seconds on 4G networks.
Unlike standard grievance apps that are just "forms and databases," CitizenConnect adds a layer of intelligence and real-time interactivity:
- 🤖 Intelligent Auto-Assignment: The system doesn't just dump complaints into a pile. It intelligently routes complaints to the specific Department Employee based on the complaint's Domain and Category mapping immediately upon submission.
- 🗺️ Live Geo-Spatial Heatmap: Admins don't just read lists; they visualize problem "Hotspots" on a live map, utilizing real GPS coordinates captured from citizen devices to identify high-density trouble zones.
- 🔔 Bi-Directional Real-Time Ecosystem:
- Citizen raises complaint ➡️ Admin gets instant socket notification.
- Admin resolves complaint ➡️ Citizen phone updates instantly.
- 🏢 Multi-Hierarchy Access Control: A complex 5-tier role system (Mayor > City Admin > Dept Admin > Ward Officer > Employee) ensures strict data security and operational hierarchy.
To bridge the gap between Digital India and Municipal Governance by providing a transparent, trackable, and efficient platform for resolving civic issues (water, electricity, roads, sanitation) with zero paperwork and minimal delay.
- Runtime: Node.js & TypeScript (for type safety and speed)
- Framework: Express.js
- Database: PostgreSQL (hosted on Neon Serverless)
- ORM: Prisma (for type-safe database queries)
- Real-Time: Socket.IO (WebSockets)
- Authentication: JWT (JSON Web Tokens) & BCrypt
- Storage: Cloudinary (Image/Video hosting)
- Deployment: Render
- Framework: Flutter (Dart)
- State Management: Provider
- Maps:
flutter_map&latlong2(OpenStreetMap) - Native Features: *
image_picker(Camera integration)geolocator(Live GPS coordinates)flutter_local_notifications(Device alerts)
- Connectivity:
socket_io_client(Real-time updates),http(REST API)
- Framework: React.js (Vite)
- UI Library: Material UI (MUI)
- Visualization: Chart.js (Analytics) & React-Leaflet (Heatmaps)
- Animations: Framer Motion
- Localization:
i18next(English, Hindi, Marathi support) - Deployment: Vercel
This project is organized as a clean Monorepo: CitizenConnect/
├── citizenconnect-backend/ # Node.js/Express API
│ ├── src/controllers/ # Business logic
│ ├── src/routes/ # API Endpoints
│ ├── src/sockets/ # Real-time event handlers
│ └── prisma/schema.prisma # Database Model
│
├── citizenconnect_mobile_app/ # Flutter Android App
│ ├── lib/screens/ # UI Pages (Login, Dashboard, Maps)
│ └── lib/services/ # API & Socket Services
│
└── citizenconnect-admin-dashboard/ # React Web Panel
├── src/pages/ # Analytics, Heatmaps, Management
└── src/components/ # Reusable UI components
- Secure Login/Register: Fast authentication with JWT.
- Raise Complaint: 3-step form with Photo Evidence and Auto-GPS Location.
- Live Tracking: Visual timeline of complaint status (Raised → Acknowledged → In Progress → Resolved).
- Public Heatmap: View all complaints in the city to see common issues nearby.
- Feedback: Rate the resolution quality (1-5 stars) after closure.
- Role-Based Dashboards: Custom views for City Admins, Ward Officers, and Dept Admins.
- Advanced Analytics: Charts for "Complaints vs. Resolution", "Avg Response Time", and "Department Performance".
- Complaint Management: Assign, Reassign, and Update status of complaints.
- Severity Heatmap: Visual identification of high-density problem zones (Green/Yellow/Red zones).
- Employee Management: Track performance of individual staff members.
- Push Notification Service: Integrate Firebase (FCM) for background alerts on mobile devices.
- AI Spam Detection: Use ML models to filter out fake or duplicate complaints automatically.
- Offline Mode: Allow citizens to draft complaints without internet and sync when online using local database storage.
- Chat Support: Direct in-app chat between the assigned employee and the citizen for faster clarification.
| Variable | Description |
|---|---|
| DATABASE_URL | PostgreSQL connection string |
| JWT_SECRET | Secret used to sign JWT tokens |
| CLOUDINARY_URL | Cloudinary upload URL |
| FRONTEND_URL | Allowed CORS origin for admin panel |
| MOBILE_APP_URL | Allowed CORS origin for mobile app |
| SOCKET_ORIGIN | Allowed origin for socket connections |
| Variable | Description |
|---|---|
| VITE_API_BASE_URL | Backend API base URL |
| Variable | Description |
|---|---|
| BASE_URL | Flutter/ Android Studios base URL (if using any) |
| SOCKET_BASE_URL | YOUR_SOCKET_BASE_URL |
Swagger documentation available at: https://citizenconnect-zbfh.onrender.com/api-docs
Here are the output screenshots of the project:
- Node.js (v18+)
- Flutter SDK
- PostgreSQL Database (Local or Cloud)
- cd citizenconnect-backend
- npm install
- npx prisma generate
- npx prisma db push
- npm run dev
- cd citizenconnect-admin-dashboard
- npm install
- npm run dev
- cd citizenconnect_mobile_app
- flutter pub get
- flutter run
🤝 Contributing
Contributions, suggestions, and improvements are always welcome! Follow conventional commits and create a pull request.