Grocery Management App 🛒

A Flutter application for managing household groceries with storage tracking, shopping lists, expiry notifications, and barcode scanning.

✨ Features

🔐 Authentication

• Email/Password Sign Up and Login
• Email Verification & Password Reset
• Google Sign-In Integration
• Secure Authentication via Firebase

📦 Storage Management

• Manage Multiple Storage Areas (Refrigerator, Freezer, Pantry, etc.)
• Track Product Details:
  • Name
  • Category
  • Manufacturing Date
  • Expiry Date (with alerts)
  • Quantity and Unit
  • Additional Notes
• Details Recognition using OpenFoodFacts API

🛍 Shopping List

• Add Items with Quantity & Units
• Real-time Updates
• Mark Items as Complete
• Batch Delete Completed Items
• Quick Add Functionality
• Barcode Scanning for Quick Item Addition

📸 Product Image Support

• Scan Barcodes to auto-fetch product details via OpenFoodFacts API
• Capture and Upload Images for grocery items
• OCR Recognition for expiry dates

🌟 Responsive Design

• Optimized for Mobile & Tablet
• Portrait & Landscape Support
• Adaptive Layouts for Different Screen Sizes

🛠 Technology Stack

• Frontend: Flutter
• Backend: Firebase
  • Authentication
  • Cloud Firestore
  • Real-time Database
• External API: OpenFoodFacts API for product details

📌 Prerequisites

• Flutter (Latest Version)
• Dart SDK
• Firebase Account
• Android Studio / VS Code
• Git

⚡ Installation

1. Clone the repository

git clone https://github.com/Black-Lights/grocery_app.git  

2. Navigate to the project directory

cd grocery_app  

3. Install dependencies

flutter pub get  

4. Configure Firebase

   • Create a Firebase project
   • Add Android/iOS apps in Firebase console
   • Download & add configuration files
   • Enable Authentication methods (Email/Password & Google Sign-In)
   • Set up Cloud Firestore

5. Run the app

flutter run  

🔥 Firebase Configuration

Firestore Rules

rules_version = '2';  
service cloud.firestore {  
  match /databases/{database}/documents {  
    match /users/{userId} {  
      allow read, write: if request.auth != null && request.auth.uid == userId;  
      
      match /areas/{areaId} {  
        allow read, write: if request.auth != null && request.auth.uid == userId;  
      }  
      
      match /shopping_list/{itemId} {  
        allow read, write: if request.auth != null && request.auth.uid == userId;  
      }  
    }  
  }  
}  

📂 Project Structure

lib/
├── models/
│   ├── area.dart
│   ├── product.dart
│   ├── shopping_item.dart
├── services/
│   ├── firestore_service.dart
│   ├── shopping_service.dart
│   ├── barcode_scanner.dart
│   └── openfoodfacts_service.dart
├── pages/
│   ├── login.dart
│   ├── signup.dart
│   ├── forgot_password.dart
│   ├── verify.dart
│   ├── homepage.dart
│   ├── shopping_list_page.dart
│   ├── product_details_page.dart
│   └── settings_page.dart
└── main.dart

🚀 Features in Detail

📦 Storage Areas

• Default storage areas provided
• Add custom storage areas
• View products by area
• Track expiry dates with notifications
• Manage quantities

📌 Product Management

• Add products with details
• Track expiry dates (with alerts)
• Monitor quantities
• Add notes & categorize products
• Scan barcodes for quick entry
• Fetch product details from OpenFoodFacts API

🛍 Shopping List

• Quick add items
• Specify quantities & units
• Mark items as purchased
• Clear completed items
• Real-time updates
• Barcode scanning for faster entry

📱 Responsive Design

The app is designed to work seamlessly across different devices and orientations:

📱 Mobile

• Portrait: Optimized single-column layout
• Landscape: Adapted two-column layout

📟 Tablet

• Enhanced spacing & typography
• Optimized input fields
• Better use of available space
• Side-by-side layouts where appropriate

🛠 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙌 Acknowledgments

• Firebase for backend services
• Flutter team for the amazing framework
• GetX for state management
• OpenFoodFacts for barcode product details
• All contributors and testers

📞 Contact

Project Link: https://github.com/Black-Lights/grocery_app

📸 Screenshots

🚀 Future Enhancements

• Enhanced Product Image Support
• Improved Expiry Recognition using OCR
• Shopping List Sharing
• Detailed Statistics & Analytics
• Multiple Themes
• Language Support

---

Made with ❤️ by Ammar and Moldir