โโโโโโโโโโโโโโ โโโ โโโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโ โโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโ โโโโ โโโโโโ โโโ โโโโโโ โโโ โโโโโโโโโโโโโโ โโโ โโโ โโโ โโโโโโโ โโโโโโ โโโ โโโโโโ โโโ โโโโโโโโโโโโโโ โโโ โโโ โโโ โโโโโ โโโ โโโโโโโ โโโ โโโ โโโ โโโโโโโโโโโ โโโโโโโโโโโ โโโ โโโ โโโ โโโโโโ โโโ โโโ โโโ โโโโโโโโโโโ โโโโโโโโโโ โโโ โโโ
Features โข Screenshots โข Installation โข Usage โข Tech Stack โข Contributing
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ โ โ โโโโโโโโ โโโโโโ โโโโ โโโโ โโโโโโ โโโโโโโ โโโ โโโ โโโโโโ โโโโ โโโ โ โ โโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโ โ โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโ โโโ โ โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ โ โโโโโโโโโโโ โโโโโโ โโโ โโโโโโ โโโโโโโโโโโโโโ โโโโโโ โโโโโโ โโโโโโ โ โ โโโโโโโโโโโ โโโโโโ โโโโโโ โโโโโโโโโโ โโโ โโโโโโ โโโโโโ โโโโโ โ โ โ โ ๐๏ธ Your City โข Your Voice โข Your Solution ๐๏ธ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Samadhan (เคธเคฎเคพเคงเคพเคจ) is a revolutionary mobile application that bridges the gap between citizens and civic authorities. Report infrastructure issues, track their resolution, and contribute to building a better city - all from your smartphone!
To create smarter, more responsive cities by empowering citizens to actively participate in urban development and maintenance.
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
|
|
|
- ๐ฆ Smart Categorization: AI-powered issue classification
- ๐ Heat Maps: Visualize problem areas in your city
- ๐ Gamification: Earn badges for civic participation
- ๐ Multi-language Support: Available in 10+ languages
- ๐ Smart Notifications: Get updates that matter
- ๐ฑ Offline Mode: Report issues without internet
dependencies:
flutter:
sdk: flutter
# Core Features
geolocator: ^9.0.2
google_maps_flutter: ^2.5.0
image_picker: ^1.0.4
# State Management
provider: ^6.0.5
# Backend & Database
firebase_core: ^2.24.0
cloud_firestore: ^4.13.3
firebase_auth: ^4.15.0
firebase_storage: ^11.5.3
# UI/UX
flutter_animate: ^4.2.0
shimmer: ^3.0.0
lottie: ^2.7.0- Flutter SDK (3.0 or higher)
- Dart SDK (3.0 or higher)
- Android Studio / VS Code
- Firebase account
๐ฑ Mobile App Setup
-
Clone the repository
git clone https://github.com/PHom798/fix-the-city-.git cd fix-the-city-/fixthecity -
Install dependencies
flutter pub get
-
Firebase Configuration
- Create a new Firebase project
- Download
google-services.json(Android) andGoogleService-Info.plist(iOS) - Place them in respective directories:
- Android:
android/app/ - iOS:
ios/Runner/
- Android:
-
API Keys Setup Create a
.envfile in the root directory:GOOGLE_MAPS_API_KEY=your_google_maps_api_key FIREBASE_API_KEY=your_firebase_api_key
-
Run the app
flutter run
๐ง Development Setup
-
Enable Developer Mode
flutter config --enable-web flutter config --enable-windows-desktop flutter config --enable-macos-desktop flutter config --enable-linux-desktop
-
Run Tests
flutter test -
Build for Production
# Android flutter build apk --release # iOS flutter build ios --release
- Sign Up/Login using your phone number or social accounts
- Allow location permissions for accurate reporting
- Tap the "+" button to report a new issue
- Take a photo, add description, and select category
- Submit and track your report in the "My Reports" section
- Access admin dashboard with official credentials
- View incoming reports sorted by priority and location
- Assign to departments and set resolution timelines
- Update status and communicate with citizens
- Mark as resolved with evidence photos
We believe in the power of community! Here's how you can contribute:
- Fork the Project
- Create your Feature Branch
git checkout -b feature/AmazingFeature
- Commit your Changes
git commit -m 'Add some AmazingFeature' - Push to the Branch
git push origin feature/AmazingFeature
- Open a Pull Request
- Check existing issues first
- Create a detailed bug report with:
- Device information
- Steps to reproduce
- Expected vs actual behavior
- Screenshots if applicable
We'd love to hear your ideas! Please create an issue with:
- Clear feature description
- Use cases
- Mockups/sketches (if any)
View Full Roadmap
- User authentication
- Issue reporting with photos
- GPS integration
- Basic tracking system
- AI-powered issue categorization
- Multi-language support
- Offline mode
- Push notifications
- AR visualization of reported issues
- Blockchain-based transparency system
- Integration with city databases
- Predictive analytics dashboard
- Smart city IoT integration
- Cross-platform desktop apps
- Open API for third-party developers
- International expansion
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2024 Samadhan Team
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction...
- Flutter Team for the amazing framework
- Firebase for backend infrastructure
- Our Contributors for their valuable input
- Citizens who believe in positive change
- You for reading this far!
Be part of the change! Join our Discord server to connect with other civic-minded individuals.
โโโโโโ โโโโโ โโโ โโโ โโโโโ โโโโโโ โโ โโ โโโโโ โโโ โโ
โโ โโ โโ โโโโ โโโโ โโ โโ โโ โโ โโ โโ โโ โโ โโโโ โโ
โโโโโโโ โโโโโโโ โโ โโโโ โโ โโโโโโโ โโ โโ โโโโโโโ โโโโโโโ โโ โโ โโ
โโ โโ โโ โโ โโ โโ โโ โโ โโ โโ โโ โโ โโ โโ โโ โโ โโ
โโโโโโ โโ โโ โโ โโ โโ โโ โโโโโโ โโ โโ โโ โโ โโ โโโโ
Made with โค๏ธ by citizens, for citizens