ShopSync

Share shopping lists with family and friends

Warning

I have started using a new authentication system within GitHub. As a result, previous commits from 13 March 2026 and before may have an "Unverified" badge. This is because those commits were made using the old authentication method. Moving forward, all new commits will be verified with the new system, ensuring that they display a "Verified" badge. I have implemented this system due to a rise in infostealer attacks across GitHub, Discord, as well as fake CAPTCHAs on compromised sites. This new authentication method provides an additional layer of security to protect against such attacks. Read more on www.infostealers.com by Hudson Rock: What is an info-stealer?

📱 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/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. 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