Flow iQ is a revolutionary clinical-grade period tracking platform that combines cutting-edge AI with comprehensive health analytics. Built with Flutter, it offers a beautiful, intuitive experience focused on privacy and reproductive wellness.

• 🧠 AI-Powered Insights backed by medical research (ACOG, NIH, NEJM)
• 📊 Advanced Cycle Prediction using machine learning
• 🔍 Comprehensive Symptom Tracking and pattern recognition
• 📚 Evidence-Based Recommendations with medical citations
• ⚕️ Medical Compliance - positioned as wellbeing analytics tool

• 🩸 Period flow, symptoms, and mood tracking
• 💊 Medication and supplement logging
• 😴 Sleep quality and exercise monitoring
• 🍎 Nutritional insights and recommendations
• 📸 Photo journaling and notes

• 📅 Accurate cycle forecasting
• 🌸 Fertility window calculations
• ⚡ PMS symptom predictions
• 🔄 Ovulation tracking
• 🔔 Personalized health alerts

• 🔐 End-to-end encryption
• 🏥 HIPAA-ready infrastructure
• ✅ Complete data control
• 🤝 Optional healthcare provider sync
• ☁️ Secure cloud backup

• 🎨 Modern, clean interface
• 🌙 Auto/Light/Dark mode support
• 🎭 Customizable themes
• 📈 Easy-to-read charts and visualizations
• 👆 Gesture-based navigation

• Flutter SDK (3.0.0 or higher)
• Dart SDK (3.0.0 or higher)
• iOS 13.0+ / Android 5.0+
• Xcode 14+ (for iOS development)
• Android Studio / VS Code

1. Clone the repository

   git clone https://github.com/ronospace/Flow-iQ.git
   cd Flow-iQ

2. Install dependencies

   flutter pub get

3. Configure Firebase

   • Add your google-services.json (Android) to android/app/
   • Add your GoogleService-Info.plist (iOS) to ios/Runner/

4. Run the app

   # iOS
   flutter run -d "iPhone 15 Pro"
   
   # Android
   flutter run -d "Android Emulator"
   
   # Web
   flutter run -d chrome

Use these credentials to explore the app:

• Email: demo@flowiq.health
• Password: FlowIQ2024Demo!

flutter build ipa --release

See IOS_EXPORT_GUIDE.md for detailed instructions.

flutter build appbundle --release

See ANDROID_RELEASE_GUIDE.md for detailed instructions.

• App Store Metadata - Complete App Store submission guide
• Screenshot Guide - Creating professional screenshots
• Clinical Compliance - Medical compliance and regulatory requirements
• Medical Sources - Research citations and references
• Rejection Fix Guide - Latest App Store submission updates
• Compliance Checklists - Version-specific compliance documentation (PDF & Markdown)

• Framework: Flutter 3.x
• Language: Dart 3.x
• State Management: Provider
• Backend: Firebase (Auth, Firestore, Analytics, Crashlytics)
• Local Storage: Shared Preferences
• Design System: Custom Flow iQ Visual System

lib/
├── main.dart                 # App entry point
├── screens/                  # UI screens
│   ├── auth_screen.dart
│   ├── home_screen.dart
│   ├── tracking_screen.dart
│   ├── insights_screen.dart
│   ├── health_diagnosis_screen.dart
│   └── settings_screen.dart
├── services/                 # Business logic
│   ├── enhanced_auth_service.dart
│   ├── flow_iq_sync_service.dart
│   ├── enhanced_ai_service.dart
│   ├── ml_prediction_service.dart
│   └── theme_service.dart
├── widgets/                  # Reusable components
├── themes/                   # Visual system & themes
└── models/                   # Data models

# Run unit tests
flutter test

# Run integration tests
flutter drive --driver=test_driver/integration_test.dart --target=integration_test/app_test.dart

# Analyze code
flutter analyze

• Fixed app crash issues
• Enhanced Provider dependency management
• Added theme service with persistent storage
• Medical compliance improvements
• App Store submission ready

• Integration with wearable devices (Apple Watch, Fitbit)
• Advanced data visualization
• Social features and community
• Offline-first architecture
• Custom themes and branding

• Advanced AI health coaching
• Third-party integrations
• Advanced export formats (PDF reports)
• Multi-language support
• Healthcare provider portal

This is a proprietary project owned by ZyraFlow Inc. For collaboration inquiries, please contact us through official channels.

Flow iQ and Flow Ai are developed and maintained by ZyraFlow Inc.™ (© 2025 ZyraFlow Inc. All rights reserved.)

These applications work together as a comprehensive menstrual health ecosystem:

• Flow iQ - Consumer-facing AI-powered period tracking app
• Flow Ai - Professional healthcare platform for clinical integration

Both applications share core technology and are part of the ZyraFlow health intelligence platform.

This project is proprietary software.

© 2025 ZyraFlow Inc.™ All rights reserved.

Unauthorized copying, modification, distribution, or use of this software, via any medium, is strictly prohibited without explicit written permission from ZyraFlow Inc.

• 📧 Email: support@zyraflow.com
• 🐛 Issues: GitHub Issues
• 📖 Documentation: Full Docs

• 🌐 Website: [Coming Soon]
• 💼 LinkedIn: ZyraFlow Inc.
• 🐦 Twitter: @ZyraFlow

• Flutter team for the amazing framework
• Firebase for backend infrastructure
• Medical research contributors (ACOG, NIH, NEJM)
• Open source community
• All beta testers and early users

Flow iQ is committed to protecting your privacy. We implement:

• End-to-end encryption for sensitive data
• HIPAA-compliant infrastructure
• No data sharing without explicit consent
• Complete user data control and deletion rights

Read our full Privacy Policy

Flow iQ is designed as a clinical decision support tool and wellbeing analytics platform. It is not intended to diagnose, treat, cure, or prevent any disease. Always consult with a qualified healthcare professional for medical advice, diagnosis, or treatment.