🛒 SmartGrocery App

The App is a smart, collaborative platform designed to simplify household shopping. It enables family members to manage a shared list, track updates in real-time, and receive predictive suggestions based on purchase history.

The system integrates:

• Machine Learning for purchase prediction.

• APIs for real-time price comparison across nearby stores.

• GPS-based search to find the cheapest nearby markets.

• Real-time synchronization using WebSockets.

This solution empowers households to make informed, cost-efficient shopping decisions while maintaining convenience and collaboration.

The App:

1. Login

Access your account

2. Choose Location

Set your preferred shopping area.

3. Home Screen

View suggested products and navigate between app sections.

4. Groups

Manage household groups

5. All Products

Search and browse catalog

6. Shopping List

Manage shared items

7. Top 5 Markets

Find cheapest nearby stores

8. Mark as Purchased

Check off items while shopping to keep the list up to date.

9. History

Track all changes

🧩 Project Architecture

Backend

• Node.js + Express – RESTful API server

• MongoDB (Mongoose) – NoSQL database

Frontend

• React Native (Expo) – Cross-platform mobile app

• React Navigation – App navigation

• Socket.IO Client – Real-time synchronization

• React Native Maps – Location display

Machine Learning

• TensorFlow.js, scikitjs, ml-logistic-regression – Predictive analytics

External APIs

• OpenStreetMap Nominatim – Location and geocoding

• CHP Price API – Product and price data retrieval

Installation & Run

# Clone repository
git clone https://github.com/sondoszo25/GroceryPredictorApp.git

# Install dependencies
npm install

# Run backend
cd ServerSide
npm start

# Run frontend
cd SmartGroceryApp
npx expo start

---

Developed as part of the B.Sc. Final Project in Computer Science
© 2025 Sondos Zoabi & Mohammed Ibrahim