A comprehensive dating safety app designed specifically for men, providing background checks, community warnings, and safety tools to navigate the modern dating landscape safely.
- Background Checks: Comprehensive verification including criminal records, sex offender registry, and financial fraud history
- Reverse Image Search: Detect catfish profiles using stolen photos
- Phone Number Verification: Validate phone numbers against scammer databases
- AI Catfish Detection: Advanced algorithms to identify fake profiles
- Financial Fraud Protection: Alerts for money requests and investment scams
- Anonymous Warnings: Share experiences without revealing identity
- Community Reports: Crowdsourced database of known scammers
- Safety Tips: Learn from collective community experience
- Verification Badges: Build trust with identity verification
- End-to-End Encryption: All sensitive data encrypted
- Anonymous Reporting: Share warnings without compromising identity
- PII Protection: Automatic detection and removal of personal information
- Secure Storage: Industry-standard encryption for all user data
- Flutter SDK (3.8.1 or higher)
- Firebase CLI
- Android Studio / Xcode for mobile development
-
Clone the repository
git clone https://github.com/yourusername/wingman.git cd wingman -
Install dependencies
flutter pub get
-
Firebase Setup
# Install Firebase CLI if not already installed npm install -g firebase-tools # Login to Firebase firebase login # Initialize Firebase in your project firebase init # Generate Firebase configuration flutterfire configure
-
Run the app
flutter run
lib/
├── main.dart # App entry point
├── firebase_options.dart # Firebase configuration
├── models/ # Data models
│ ├── user.dart # User model with safety features
│ ├── safety_report.dart # Community reports and warnings
│ └── background_check.dart # Background check results
├── services/ # Business logic
│ ├── auth_service.dart # Authentication and user management
│ ├── background_check_service.dart # Safety verification
│ └── privacy_service.dart # Encryption and anonymization
├── screens/ # UI screens
│ ├── auth/ # Login and registration
│ ├── home/ # Dashboard and overview
│ ├── safety/ # Safety tools and background checks
│ └── community/ # Community warnings and tips
└── widgets/ # Reusable UI components
- Firebase Authentication integration
- User profile management
- Email/phone verification
- Account security features
- Phone number validation
- Criminal record searches
- Social media profile verification
- Risk score calculation
- Data encryption/decryption
- PII detection and removal
- Anonymous identifier generation
- Security event logging
- AES-256 Encryption: All sensitive data encrypted at rest
- SHA-256 Hashing: Phone numbers and emails hashed for lookups
- Anonymous Reporting: Community features preserve user privacy
- GDPR Compliant: Full user data control and deletion rights
- Rate Limiting: Prevents abuse of background check APIs
- Input Validation: Protects against injection attacks
- Secure Storage: Sensitive data never stored in plain text
- Audit Logging: Security events logged without PII
The app integrates with various verification services:
- Criminal background check services
- Phone number validation APIs
- Social media verification
- Reverse image search
- Scammer databases
Create a .env file with your API keys:
BACKGROUND_CHECK_API_KEY=your_api_key
PHONE_VERIFICATION_API_KEY=your_api_key
IMAGE_SEARCH_API_KEY=your_api_key
We welcome contributions to improve Wingman's safety features:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow Flutter/Dart style guidelines
- Add tests for new features
- Update documentation for API changes
- Ensure privacy and security best practices
- ✅ Android (API 21+)
- ✅ iOS (iOS 12.0+)
- ✅ Web (Chrome, Firefox, Safari, Edge)
- 🔄 macOS (Coming soon)
- 🔄 Windows (Coming soon)
flutter test# Android
flutter build apk --release
# iOS
flutter build ios --release
# Web
flutter build web --releaseflutter analyze- App startup time: < 2 seconds
- Background check completion: 30-60 seconds
- Community data sync: Real-time
- Offline functionality: Core features available
- Lazy loading for large datasets
- Image caching and compression
- Background processing for heavy operations
- Efficient state management with Provider
If you discover a security vulnerability, please email [email protected] instead of opening a public issue. We take security seriously and will respond promptly.
This project is licensed under the MIT License - see the LICENSE file for details.
- Tea for Women - Inspiration for women's safety features
- Firebase - Backend infrastructure
- Flutter Community - Amazing framework and ecosystem
- Security Researchers - Vulnerability disclosure and best practices
- Documentation: docs.wingman-app.com
- Community: Discord Server
- Issues: GitHub Issues
- Email: [email protected]
Wingman is a safety tool designed to help users make informed decisions. While we strive for accuracy, no background check service is 100% complete. Users should always exercise personal judgment and follow basic safety practices when meeting new people.
Built with ❤️ for the safety of men in dating