🎭 Face Emotion Detection

This is a flutter application which detects a person's face and analyzes its condition in real-time, even in different lighting environments. You can take a selfie or back photo or upload a photo and give u the results

Core features

1. You can take a photo selfie or back or upload photo

2. I used local storage for the app using Shared_preferences

3. I used GETX in state management

4. the app architecture is very organised

5. You can use it OFFLINE

6. It has easy , simple beatuful ui

7. Work on both Android and IOS

These are the plugins i used

🛠 Tech Stack

• Flutter (SDK >= 3.0.0 < 4.0.0)
• GetX – State Management & Routing
• Google ML Kit (Face Detection)
• Camera
• Image Picker
• Permission Handler
• Shared Preferences
• Image Processing (image + flutter_image_compress)

📦 Dependencies

dependencies:
  flutter:
    sdk: flutter

  get: ^4.6.5
  camera: ^0.10.6
  google_mlkit_face_detection: ^0.11.1
  image_picker: ^1.0.0
  permission_handler: ^11.4.0
  image: ^4.0.17
  shared_preferences: ^2.2.0
  flutter_image_compress: ^2.4.0

This is The App Architecture

The project follows a feature-based modular architecture:

lib
├── app
│   ├── routes.dart
│   ├── themes.dart
├── main.dart
├── modules
│   ├── camera
│   │   ├── common_widgets.dart
│   │   ├── gallery_upload_screen.dart
│   │   ├── take_photo.dart
│   ├── home
│   │   ├── home_controllor.dart
│   │   ├── home_page.dart
│   ├── onboarding
│   │   ├── features.dart
│   │   ├── onboarding.dart
│   │   ├── onboarding_controllor.dart
│   │   ├── permissions.dart
│   │   ├── welcome_page.dart
│   ├── results
│   │   ├── result.dart
│   │   ├── result_controllor.dart
├── services
│   ├── face_analyzer.dart
├── widgets
│   ├── custom_buttom.dart

---

App Icon

📱 Screens From The Application

OnBoarding Screens

       

---

Home Page Screes

   

---

Results after take Photos

       

   

---

Results after upload Photos

       

   

---

If You use Random photo not a human

   

---

🚀 Getting Started

Follow these steps to run the project locally:

1️⃣ Clone the repository

git clone https://github.com/Manar-Elhabbal7/Face-Emotion-Detector.git
cd Face-Emotion-Detector

2️⃣ Install dependencies

flutter pub get

3️⃣ Check connected devices

flutter devices

4️⃣ Run the application

flutter run

---

🤝 Contribution Guide

Contributions are welcome and appreciated!

🛠 How to Contribute

1. Fork the repository
2. Create a new branch:

git checkout -b feature/your-feature-name

3. Make your changes
4. Commit your changes:

git commit -m "Add: short description of your feature"

5. Push your branch:

git push origin feature/your-feature-name

6. Open a Pull Request

---

📌 Contribution Rules

• Follow the existing project structure
• Use meaningful commit messages
• Keep the UI clean and consistent
• Make sure the app runs without errors before submitting PR
• Write clean and readable code

---

Testing Before PR

Before submitting a pull request, make sure:

flutter analyze
flutter test

---

Please Star the repo if you find it helpful Maintainer: Manar Elhabbal