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

Coming Soon

🌐 Translation

✨ We use Weblate!

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

🛠️ Tech Stack

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

🚀 Getting Started

Prerequisites

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

Installation

1. Clone the repository

   git clone https://github.com/aadishsamir123/asdev-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. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

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

Code Coverage (Codecov)

FOSSA