ASDev-Official/shopsync
ShopSync is an app which lets you collaborate on shopping lists with family and friends.
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
-
Clone the repository
git clone https://github.com/ASDev-Official/ShopSync.git cd asdev-shopsync -
Install dependencies
flutter pub get
-
Configure Firebase
- Create a new Firebase project
- Make sure to set up Firebase Authentication and Firestore in your Firebase project
- Add your
google-services.jsonto/android/app/ - Add your
GoogleService-Info.plistto/ios/Runner/(optional since this app currently does
not support iOS) - Follow
the Firebase setup guide
-
Run the app
flutter run
🤝 Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file
for details.
Code Coverage (Codecov)
