🛒 SmartCart – Food Waste Reduction App

A cross-platform mobile app that helps households minimize food waste through barcode scanning, smart inventory management, and nutritional tracking

✨ PRODUCTION-READY WITH AZURE INTEGRATION & REAL BARCODE SCANNING! ✨

---

📑 Table of Contents

• What's New
• Project Overview
• Core Features
• Tech Stack
• Quick Start
• Project Structure
• Scripts
• Documentation
• Contributing
• License

---

🔥 What's New

✅ Azure Authentication - Secure user accounts with Azure authentication services
✅ Azure Table Storage - Cloud-based data storage with Azure integration
✅ Real Barcode Scanning - Scan actual product barcodes with your camera using mobile_scanner
✅ Open Food Facts API - Automatic product info lookup from 2+ million products
✅ Household Management - Multi-member household setup and nutrition tracking
✅ Offline Support - Works without internet using Hive local storage
✅ Shopping List - Integrated cloud-synced shopping list feature
✅ Nutrition Insights - Track household nutrition needs and dietary preferences

---

🌱 Project Overview

SmartCart is a cross-platform mobile application built with Flutter that helps households reduce food waste by making smarter grocery purchasing decisions. The app integrates barcode scanning, Azure cloud storage, household nutrition tracking, and inventory management to promote responsible consumption.

🎯 Key Goals

• Reduce household food waste at the point of purchase
• Align grocery decisions with household nutritional needs
• Promote sustainability through awareness and insights
• Provide cloud-synced inventory management via Azure
• Enable household member management and personalized nutrition tracking

🌍 SDG Contribution

This project directly contributes to:

• SDG 12: Responsible Consumption and Production
• SDG 2: Zero Hunger
• SDG 13: Climate Action (reduced food waste = reduced emissions)

---

💡 Core Features

Feature	Status	Description
🔐 User Authentication	✅ LIVE	Azure authentication with secure login/signup
📷 Barcode Scanning	✅ LIVE	Scan real product barcodes using mobile_scanner
🌍 Product Database	✅ LIVE	Access to 2+ million products via Open Food Facts
☁️ Cloud Storage	✅ LIVE	Azure Table Storage for cloud data persistence
📦 Smart Inventory	✅ LIVE	Track products with expiry, quantities, categories
🍎 Nutrition Data	✅ LIVE	Automatic nutrition info from Open Food Facts
👥 Household Management	✅ LIVE	Multi-member household setup and tracking
⚠️ Expiry Alerts	✅ LIVE	Get notified about expiring products
🛒 Shopping List	✅ LIVE	Cloud-synced shopping list management
📱 Offline Mode	✅ LIVE	Works offline with Hive local storage
🎨 Onboarding	✅ LIVE	Interactive introduction screens for new users

---

🧱 Tech Stack

Layer	Tools & Frameworks
Language	Dart 3.0+
Framework	Flutter 3.0+
Authentication	Azure Authentication Services
Cloud Storage	Azure Table Storage
Local Database	Hive (NoSQL, offline storage)
State Management	Provider
Barcode API	Open Food Facts API
Scanner	mobile_scanner, qr_code_scanner
API Client	Dio (HTTP), http
Charts	fl_chart
UI	Material Design 3, Google Fonts
Permissions	permission_handler
PDF Export	pdf, printing
Onboarding	introduction_screen

---

🚀 Quick Start

Prerequisites

• Flutter SDK 3.0+ (Install Flutter)
• Dart SDK 3.0+
• VS Code or Android Studio with Flutter extensions
• Git
• Azure account with Table Storage configured
• For Android: Android SDK, emulator or physical device
• For Windows: Windows 10+ (for Windows desktop builds)

Installation

1. Clone the repository

   git clone https://github.com/yourusername/smartcart.git
   cd smartcart

2. Install dependencies

   flutter pub get

   Or use the setup script:

   .\scripts\setup.ps1 get

3. Configure Azure credentials (Important!)

   Copy-Item lib\config\azure_config.dart.template lib\config\azure_config.dart

   Edit lib/config/azure_config.dart with your Azure Storage account credentials.

   📚 See docs/SETUP_CREDENTIALS.md and docs/AZURE_SETUP.md for details.

4. Generate Hive adapters

   flutter pub run build_runner build --delete-conflicting-outputs

5. Run the app

   flutter run

For detailed setup instructions, see docs/QUICK_START.md.

---

📂 Project Structure

smartcart/
├── lib/                          # Main application code
│   ├── main.dart                 # App entry point
│   ├── config/                   # Configuration files
│   │   ├── azure_config.dart     # Azure credentials (gitignored)
│   │   └── azure_config.dart.template
│   ├── models/                   # Data models (Hive)
│   │   ├── product.dart
│   │   ├── household_member.dart
│   │   ├── nutrition.dart
│   │   └── sustainability.dart
│   ├── screens/                  # UI screens
│   │   ├── home_screen.dart
│   │   ├── login_screen.dart
│   │   ├── register_screen.dart
│   │   ├── splash_screen.dart
│   │   ├── onboarding_screen.dart
│   │   ├── scanner_screen.dart
│   │   ├── inventory_screen.dart
│   │   ├── initial_inventory_setup_screen.dart
│   │   ├── shopping_list_screen.dart
│   │   ├── nutrition_screen.dart
│   │   ├── household_setup_screen.dart
│   │   ├── household_management_screen.dart
│   │   ├── household_nutrition_screen.dart
│   │   └── product_detail_screen.dart
│   ├── services/                 # Business logic & APIs
│   │   ├── azure_auth_service.dart
│   │   ├── azure_table_service.dart
│   │   ├── barcode_service.dart
│   │   └── local_storage_service.dart
│   ├── providers/                # State management
│   │   ├── inventory_provider.dart
│   │   └── nutrition_provider.dart
│   └── widgets/                  # Reusable widgets
│       ├── product_card.dart
│       └── household_info_card.dart
├── assets/                       # Images, icons
│   ├── icons/
│   └── images/
├── android/                      # Android platform code
├── windows/                      # Windows platform code
├── test/                         # Unit & widget tests
├── docs/                         # Documentation
│   ├── QUICK_START.md
│   ├── BUILD_GUIDE.md
│   ├── HOT_RELOAD_GUIDE.md
│   ├── SETUP_CREDENTIALS.md
│   ├── ARCHITECTURE.md
│   ├── FIREBASE_STRUCTURE.md
│   └── ...
├── scripts/                      # Build & setup scripts
│   ├── setup.ps1
│   ├── build_playstore.ps1
│   ├── clean_build_apk.ps1
│   ├── quick_build.ps1
│   └── fix_qr_scanner.ps1
├── pubspec.yaml                  # Dependencies
├── analysis_options.yaml         # Linting rules
└── README.md                     # This file

For detailed architecture, see docs/ARCHITECTURE.md.

---

🔧 Scripts

All scripts are located in the scripts/ folder:

Script	Description
setup.ps1	Interactive setup and run helper
build_playstore.ps1	Build release APK/AAB for Play Store
clean_build_apk.ps1	Clean build directory and rebuild APK
quick_build.ps1	Quick debug APK build
fix_qr_scanner.ps1	Fix QR scanner permissions
add_keells_products.ps1	Populate product database with Keells products
add_biscuits_crackers.ps1	Add biscuits and crackers to product database
populate_shopping_list.ps1	Populate shopping list with sample data
save_to_shopping_table.ps1	Save data to Azure shopping table
setup.bat	Windows batch setup script

Usage Examples

# Interactive setup
.\scripts\setup.ps1

# Get packages
.\scripts\setup.ps1 get

# Build for production
.\scripts\build_playstore.ps1

# Clean and rebuild
.\scripts\clean_build_apk.ps1

For more details, see docs/BUILD_GUIDE.md.

---

📚 Documentation

All documentation is organized in the docs/ folder:

Getting Started

• 📖 Quick Start Guide - Get up and running in minutes
• 🔧 Setup Credentials - Configure Azure & Firebase
• 🏗️ Build Guide - Building for different platforms

Architecture & Design

• 🏛️ Architecture Overview - System design and patterns
• 📊 Architecture Diagram - Visual system overview
• 🔥 Firebase Structure - Database schema (legacy reference)
• 👥 User Data Separation - Privacy & security
• 🛒 Shopping List Feature - Shopping list implementation

Azure Integration

• ☁️ Azure Setup - Complete Azure configuration
• 📝 Azure Tables Quickstart - Table storage guide
• 🔐 Azure Authentication - Auth setup
• 🔒 Azure Only Auth - Azure-only authentication
• 📦 Azure Table Creation - Creating tables

Development

• 🔥 Hot Reload Guide - Fast development workflow
• 🔒 Secure Credentials - Credential management
• 🛠️ Implementation Summary - Feature implementation
• 🗺️ Roadmap - Future features & plans
• 📱 QR Code Samples - Test barcodes

Troubleshooting

• 🔧 Login/Signup Fix - Auth troubleshooting

---

🤝 Contributing

We welcome contributions! Please follow these guidelines:

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

Please ensure:

• Code follows Dart/Flutter style guidelines
• All tests pass
• Documentation is updated
• No credentials are committed

---

📄 License

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

---

🙏 Acknowledgments

• Open Food Facts - Product database API providing nutrition information
• Azure - Cloud infrastructure and storage services
• Flutter Team - Amazing cross-platform framework
• Keells Supermarket - Product data for Sri Lankan grocery items
• Contributors - Thank you for your support!

---

---

Made with ❤️ for a sustainable future

Reducing food waste, one scan at a time