ShopSync

Share shopping lists with family and friends

📱 Overview

ShopSync is an intuitive Flutter application that simplifies shared shopping experiences. Create and manage shopping lists in real-time with family and friends.

✨ Features

• 🔄 Real-time cloud synchronization
• 📴 Offline access capability
• 🗑️ Recycle bin for deleted items
• 👥 Multi-user collaboration
• 🌓 Dark/Light theme support

📱 Screenshots

🌐 Translations/Localisation

✨ We use Weblate!

To make ShopSync available in multiple languages, contribute to our Weblate

ShopSync App (app.shopsync.aadish.dev, Android Phone app, WearOS app)

ShopSync Website (shopsync.aadish.dev)

🛠️ Tech Stack

• Flutter
• Firebase
• Dart
• Provider State Management
• Shared Preferences
• Cloud Firestore

🚀 Getting Started

Prerequisites

• Flutter SDK (^3.41.5)
• Dart SDK
• Firebase account
• Android Studio / VS Code

Installation

1. Clone the repository

   git clone https://github.com/ASDev-Official/ShopSync.git
   cd asdev-shopsync

2. Install dependencies

   flutter pub get

3. Configure Firebase

   • Create a new Firebase project
   • Make sure to set up Firebase Authentication and Firestore in your Firebase project
   • Add your google-services.json to /android/app/
   • Add your GoogleService-Info.plist to /ios/Runner/(optional since this app currently does not support iOS)
   • Follow the Firebase setup guide

4. Run the app

   flutter run

🤝 Contributing

1. An amazing file exists called CONTRIBUTING.md that you should read before contributing.

📄 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

FOSSA