Skip to content

Latest commit

 

History

History
117 lines (86 loc) · 3.12 KB

File metadata and controls

117 lines (86 loc) · 3.12 KB

🛍️ ShopSmart – Your Smart Shopping Companion

MIT License Kotlin Jetpack Compose

A modern Android shopping companion app that revolutionizes your local shopping experience with smart features and intuitive design.

📱 Key Features

🔍 Smart Shopping

  • Voice & text-based product search with AI-powered suggestions
  • Real-time inventory tracking and price comparisons
  • Barcode scanning for instant product information
  • Location-based store recommendations

📋 List Management

  • Create and manage multiple shopping lists
  • Smart categorization and sorting
  • Price tracking and budget estimation
  • Share lists with family members
  • Image attachments for specific items

🔔 Smart Notifications

  • Price drop alerts for wishlist items
  • Stock availability notifications
  • Deal recommendations based on shopping history
  • Order status updates

🛠️ Tech Stack

  • Frontend:

    • Jetpack Compose
    • Material Design 3
    • View Models
    • Kotlin Coroutines
  • Backend:

    • Room Database
    • Retrofit for API calls
    • Hilt for dependency injection
    • Firebase Analytics
  • Architecture:

    • MVVM (Model-View-ViewModel)
    • Clean Architecture principles
    • Repository pattern

🚀 Getting Started

Prerequisites

  • Android Studio Arctic Fox or later
  • JDK 11 or higher
  • Android SDK 21+
  • Kotlin 1.8.0+

Installation

  1. Clone the repository
git clone https://github.com/yourusername/ShopSmart.git
  1. Open project in Android Studio

  2. Add your API keys in local.properties:

PIXABAY_API_KEY=your_key_here
MAPS_API_KEY=your_key_here
  1. Build and run the project

📸 Screenshots

Home Screen Shopping List Product Search
(Coming Soon) (Coming Soon) (Coming Soon)

🤝 Contributing

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

🥹 Thanks to fellow contributors

📜 License

Distributed under the MIT License. See LICENSE for more information.

📮 Contact


⭐️ If you find this project useful, please consider giving it a star!