Madadgar is a modern, Flutter-based mobile application that revolutionizes community aid and resource sharing. It serves as a comprehensive platform where community members can seamlessly connect to offer help and seek assistance.
Madadgar isn't just another social app—it's a purpose-built community aid ecosystem that combines modern technology with the timeless human value of helping one another. Here's what makes us different:
- 🎯 Purpose-Built for Aid: Unlike general social platforms, every feature is designed specifically for community assistance
- 🔐 Trust-First Approach: Multi-tier verification system ensures safe and reliable interactions
- 📍 Hyper-Local Focus: Find help exactly where you need it, when you need it
- 🚀 Modern Technology: Built with Flutter and Firebase for reliability and performance
- Dual Post System: Create "Need" posts (requesting help) or "Offer" posts (providing assistance)
- Category-Based Organization: Food, Clothing, Education, Medical, Services, Shelter, and more
- Location-Aware Matching: Find help and helpers in your specific region
- Verified-Private Posting: Privacy protection for sensitive requests, backed by verified identity
- Multi-tier Verification: Phone, email, and identity verification
- Madadgar Trust Score: Server-side algorithmic score tracking community trust. Max 100 points based on verification (+20), helps (+10), and thanks (+5).
- Verified Badge System: Visual trust indicators for reliable community members (Bronze, Silver, Gold tiers)
- Integrated Chat System: Direct messaging between helpers and seekers
- Post-Specific Conversations: Contextual communication threads
- Media Sharing: Image and file sharing capabilities
- Response Tracking: Monitor engagement and response rates
- Nearby Help Finder: Discover assistance opportunities in your area
- Regional Filtering: Pakistan-focused with major city support
- Geographic Privacy: Location sharing with user consent
- Multi-Level Reporting System: Report posts, users, and inappropriate content
- Content Moderation: Community-driven safety mechanisms
- Privacy Controls: Verified-private posting and selective information sharing
- Flutter SDK 3.3.x or higher
- Dart SDK 3.3.x or higher
- Android Studio / VS Code
- Firebase account and project setup
-
Clone the repository
git clone https://github.com/MahateerMuhammad/madadgar.git cd madadgar -
Install dependencies
flutter pub get
-
Firebase Setup
- Create a new Firebase project at Firebase Console
- Enable Authentication, Firestore, Storage, and Analytics
- Download and add your
google-services.json(Android) andGoogleService-Info.plist(iOS) - Configure
firebase_options.dartusing FlutterFire CLI:dart pub global activate flutterfire_cli flutterfire configure
-
Run the application
flutter run
# Android
flutter build apk --release
flutter build appbundle --release
# iOS
flutter build ios --release
# Web
flutter build web --releaselib/
├── config/ # App configuration
│ ├── constants.dart
│ ├── routes.dart
│ └── theme.dart
├── models/ # Data models
│ ├── user.dart
│ ├── post.dart
│ ├── chat.dart
│ └── report.dart
├── screens/ # UI screens
│ ├── auth/
│ ├── home/
│ ├── post/
│ ├── chat/
│ ├── profile/
│ └── verification/
├── services/ # Business logic
│ ├── auth_service.dart
│ ├── post_service.dart
│ ├── chat_service.dart
│ └── location_service.dart
├── widgets/ # Reusable components
│ ├── custom_button.dart
│ ├── custom_text_field.dart
│ └── post_card.dart
└── main.dart # App entry point
- Flutter 3.3.x - Cross-platform mobile framework
- Material Design 3 - Modern UI components
- Provider - State management
- Google Fonts - Typography (Poppins)
- Firebase Authentication - User management
- Cloud Firestore - Real-time database
- Firebase Storage - File storage
- Firebase Analytics - App analytics
- Firebase Messaging - Push notifications
- Location Services:
geolocator,geocoding - Media Handling:
image_picker,file_picker - HTTP Client:
http,dio - UI Enhancement:
flutter_animate,flutter_svg - Utilities:
share_plus,url_launcher,cached_network_image
- Supply Seeding: Partner NGOs and local businesses bypass verification holds to pre-populate the platform with offers ("supply").
- Waitlist Management: General users join a region-based waitlist and are gradually invited as supply meets demand.
- Register & Verify → Complete profile with regional information
- Create Need Post → Describe requirement with category and location
- Receive Responses → Get offers from verified community helpers
- Connect & Chat → Communicate directly with potential helpers
- Complete Exchange → Receive help and provide feedback/thanks
- Browse Community Needs → Explore local and regional help requests
- Filter by Interest → Find opportunities matching skills/resources
- Respond to Posts → Offer assistance through integrated chat
- Coordinate Help → Arrange meeting/delivery through secure messaging
- Complete Assistance → Provide help and receive community recognition
- Community Members & Neighbors - Local help seekers and providers
- NGOs & Organizations - Community aid coordination
- Local Businesses - Community service offerings
- Verified Helpers - Trusted community contributors
Currently focused on Pakistan with support for major cities:
- Karachi (Gulshan, Clifton, DHA)
- Lahore (Model Town, Gulberg)
- Islamabad (F & G Sectors)
- Rawalpindi, Peshawar, Quetta
We believe in the power of community collaboration! Whether you're a developer, designer, or community advocate, there are many ways to contribute to Madadgar:
- Fork the repository
- 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
- UI/UX improvements and suggestions
- Icon and graphic design contributions
- User experience research and feedback
- Feature suggestions based on real community needs
- Beta testing and feedback
- Documentation improvements
- Translation support (coming soon)
- Follow Flutter/Dart coding standards
- Write clear commit messages
- Add tests for new features
- Update documentation as needed
- Be respectful and inclusive in all interactions
This project is licensed under the MIT License - see the LICENSE file for details.
- Flutter Team - For creating an incredible cross-platform framework
- Firebase Team - For providing robust and scalable backend services
- Open Source Community - For the amazing packages that make development faster
- Beta Testers - For their valuable feedback and patience during development
- Community Members - For inspiring us to build something meaningful
- Contributors - Everyone who has helped make Madadgar better
If you find Madadgar helpful, please consider giving it a ⭐ on GitHub! Your support helps us reach more communities and build better features.
- v0.1.0 (Current) - Initial release with core features
- Authentication system
- Post management
- Real-time chat
- Location services
- Reporting system
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: mahateermuhammad100@gmail.com
- GitHub: @MahateerMuhammad
- Core authentication system with Firebase
- Complete post management (Create, Read, Update, Delete)
- Real-time chat system with media sharing
- Location-based services with regional filtering
- Comprehensive reporting and safety system
- Responsive UI/UX with custom theming
- Multi-platform support (Android, iOS, Web)
- Advanced verification workflows for enhanced trust
- Push notification system for real-time updates
- Enhanced search and filtering capabilities
- Performance optimizations for better scalability
- Improved user onboarding experience
- v0.3.0: AI-powered matching for better help connections
- v0.4.0: Multi-language support for broader accessibility
- v0.5.0: Advanced moderation tools with AI assistance
- v1.0.0: Federated identity verification (NADRA integration) for ultimate trust
- Beyond: Integration APIs for NGO and government systems
- Expand to other countries and regions
- Partner with international NGOs and organizations
- Implement advanced analytics for community insights
- Develop API ecosystem for third-party integrations
Madadgar is not just an app. It's a movement toward stronger, more connected communities where technology serves humanity's fundamental need to help one another.
Built with ❤️ for communities, by communities.