ShopSync Logo # ShopSync _Share shopping lists with family and friends_ [![CI](https://github.com/aadishsamir123/asdev-shopsync/actions/workflows/CI.yml/badge.svg)](https://github.com/aadishsamir123/asdev-shopsync/actions/workflows/CI.yml) [![CD-Prod-Play-Phone](https://github.com/aadishsamir123/asdev-shopsync/actions/workflows/CD-Prod-Play-Phone.yml/badge.svg)](https://github.com/aadishsamir123/asdev-shopsync/actions/workflows/CD-Prod-Play-Phone.yml) [![CD-Prod-Play-WearOS](https://github.com/aadishsamir123/asdev-shopsync/actions/workflows/CD-Prod-Play-WearOS.yml/badge.svg)](https://github.com/aadishsamir123/asdev-shopsync/actions/workflows/CD-Prod-Play-WearOS.yml) [![FOSSA License Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FASDev-Official%2Fshopsync.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2FASDev-Official%2Fshopsync?ref=badge_shield) [![FOSSA Security Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FASDev-Official%2Fshopsync.svg?type=shield&issueType=security)](https://app.fossa.com/projects/git%2Bgithub.com%2FASDev-Official%2Fshopsync?ref=badge_shield&issueType=security) [![Flutter Version](https://img.shields.io/badge/Flutter-^3.35.3-blue?logo=flutter)](https://flutter.dev) [![License](https://img.shields.io/badge/license-MIT_License-blue?logo=data:image/svg+xml;base64,PHN2ZyBmaWxsPSIjZmZmZmZmIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgdmlld0JveD0iMCAwIDE2IDE2Ij48cGF0aCBkPSJNOC43NS43NVYyaC45ODVjLjMwNCAwIC42MDMuMDguODY3LjIzMWwxLjI5LjczNmMuMDM4LjAyMi4wOC4wMzMuMTI0LjAzM2gyLjIzNGEuNzUuNzUgMCAwIDEgMCAxLjVoLS40MjdMMTUuODUyIDkuNzE5YS43NS43NSAwIDAgMS0uMTU0LjgzOGwtLjUzLS41My41MjkuNTMxLS4wMDMuMDA0LS4wMTIuMDExLS4wNDUuNDBjLS4yMS4xNzYtLjQ0MS4zMjctLjY4Ni40NUMxNC41NTYgMTAuNzggMTMuODggMTEgMTMgMTFhNC40OTggNC40OTggMCAwIDEtMi4wMjMtLjQ1NCAzLjU0NCAzLjU0NCAwIDAgMS0uNjg2LS40NWwtLjA0NS0uNDAtLjAyMi0uMDIxYS43NS43NSAwIDAgMS0uMTU0LS44MzhMMTIuMTc4IDQuNWgtLjE2MmExLjc1IDEuNzUgMCAwIDEtLjg2OC0uMjMxbC0xLjI5LS43MzZhLjI0NS4yNDUgMCAwIDAtLjEyNC0uMDMzaC0xLjI1VjEzaDIuNWEuNzUuNzUgMCAwIDEgMCAxLjVoLTYuNWEuNzUuNzUgMCAwIDEgMC0xLjVoMi41VjMuNWgtLjk4NGEuMjQ1LjI0NSAwIDAgMC0uMTI0LjAzM2wtMS4yODkuNzM3YTEuNzUgMS43NSAwIDAgMS0uODY5LjIzaC0uMTYybDIuMTEyIDQuNjkyYS43NS43NSAwIDAgMS0uMTU0LjgzOGwtLjUzLS41My41MjkuNTMxLS4wMDMuMDA0LS4wMTIuMDExLS4wNDUuNDBjLS4yMS4xNzYtLjQ0MS4zMjctLjY4Ni40NUM0LjU1NiAxMC43OCAzLjg4IDExIDMgMTFhNC40OTggNC40OTggMCAwIDEtMi4wMjMtLjQ1NCAzLjU0NCAzLjU0NCAwIDAgMS0uNjg2LS40NWwtLjA0NS0uNDAtLjAyMi0uMDIxYS43NS43NSAwIDAgMS0uMTU0LS44MzhMMi4xNzggNC41SDEuNzVhLjc1Ljc1IDAgMCAxIDAtMS41aDIuMjM0YS4yNDkuMjQ5IDAgMCAwIC4xMjUtLjAzM2wxLjI4OC0uNzM3YTEuNzUgMS43NSAwIDAgMSAuODY5LS4yM2guOTg0Vi43NWEuNzUuNzUgMCAwIDEgMS41IDBaTTExLjY5NSA5LjIyN2MuMjg1LjEzNS43MTguMjczIDEuMzA1LjI3M3MxLjAyLS4xMzggMS4zMDUtLjI3M0wxMyA2LjMyN1ptLTEwIDBjLjI4NS4xMzUuNzE4LjI3MyAxLjMwNS4yNzNzMS4wMi0uMTM4IDEuMzA1LS4yNzNMMyA2LjMyN1oiLz48L3N2Zz4=)](https://github.com/aadishsamir123/asdev-shopsync/blob/main/LICENSE) [![Android](https://img.shields.io/endpoint?color=green&logo=google-play&url=https%3A%2F%2Fplay.cuzi.workers.dev%2Fplay%3Fi%3Dcom.aadishsamir.shopsync%26gl%3DUS%26hl%3Den%26l%3DAndroid%2520Stable%26m%3D%24version)](https://play.google.com/store/apps/details?id=com.aadishsamir.shopsync) [![Website](https://img.shields.io/website?url=https%3A%2F%2Fapp.shopsync.aadish.dev&logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB3aWR0aD0iMTZweCIgaGVpZ2h0PSIxNnB4IiB2aWV3Qm94PSIwIDAgMTYgMTYiIHZlcnNpb249IjEuMSI+CjxnIGlkPSJzdXJmYWNlMSI+CjxwYXRoIHN0eWxlPSJmaWxsOm5vbmU7c3Ryb2tlLXdpZHRoOjI2O3N0cm9rZS1saW5lY2FwOmJ1dHQ7c3Ryb2tlLWxpbmVqb2luOm1pdGVyO3N0cm9rZTpyZ2IoMjU1LDI1NSwyNTUpO3N0cm9rZS1vcGFjaXR5OjE7c3Ryb2tlLW1pdGVybGltaXQ6NDsiIGQ9Ik0gMjA4Ljk3NDYwOSAxNC45NzA3MDMgQyAxMDEuNTEzNjcyIDE1LjU4NTkzNyAxNC43NjU2MjUgMTAyLjk0OTIxOSAxNC45NzA3MDMgMjEwLjUxMjY5NSBDIDE1LjI3ODMyIDMxNy45NzM2MzMgMTAyLjUzOTA2MiA0MDUuMDI5Mjk3IDIxMCA0MDUuMDI5Mjk3IEMgMzE3LjQ2MDkzNyA0MDUuMDI5Mjk3IDQwNC43MjE2OCAzMTcuOTczNjMzIDQwNS4wMjkyOTcgMjEwLjUxMjY5NSBDIDQwNS4yMzQzNzUgMTAyLjk0OTIxOSAzMTguNDg2MzI4IDE1LjU4NTkzNyAyMTEuMDI1MzkxIDE0Ljk3MDcwMyBaIE0gMjA4Ljk3NDYwOSAxNC45NzA3MDMgIiB0cmFuc2Zvcm09Im1hdHJpeCgwLjAzODA5NTIsMCwwLDAuMDM4MDk1MiwwLDApIi8+CjxwYXRoIHN0eWxlPSJmaWxsOm5vbmU7c3Ryb2tlLXdpZHRoOjE4O3N0cm9rZS1saW5lY2FwOmJ1dHQ7c3Ryb2tlLWxpbmVqb2luOm1pdGVyO3N0cm9rZTpyZ2IoMjU1LDI1NSwyNTUpO3N0cm9rZS1vcGFjaXR5OjE7c3Ryb2tlLW1pdGVybGltaXQ6NDsiIGQ9Ik0gMjEwIDE0Ljk3MDcwMyBMIDIxMCA0MDUuMDI5Mjk3IE0gNDA1LjAyOTI5NyAyMTAgTCAxNC45NzA3MDMgMjEwIE0gNTguOTU5OTYxIDkwLjAyOTI5NyBDIDE0OS4zOTk0MTQgMTU0LjQyMzgyOCAyNzAuNjAwNTg2IDE1NC40MjM4MjggMzYxLjA0MDAzOSA5MC4wMjkyOTcgTSAzNjEuMDQwMDM5IDMyOS45NzA3MDMgQyAyNzAuNjAwNTg2IDI2NS41NzYxNzIgMTQ5LjM5OTQxNCAyNjUuNTc2MTcyIDU4Ljk1OTk2MSAzMjkuOTcwNzAzIE0gMTk1LjAyOTI5NyAxOS45OTUxMTcgQyAxMzguNzM1MzUyIDY3LjQ3MDcwMyAxMDYuMzMzMDA4IDEzNy40MDIzNDQgMTA2LjMzMzAwOCAyMTEuMDI1MzkxIEMgMTA2LjMzMzAwOCAyODQuNjQ4NDM3IDEzOC43MzUzNTIgMzU0LjQ3NzUzOSAxOTUuMDI5Mjk3IDQwMS45NTMxMjUgTSAyMjQuOTcwNzAzIDQwMS45NTMxMjUgQyAyODEuMjY0NjQ4IDM1NC40Nzc1MzkgMzEzLjY2Njk5MiAyODQuNjQ4NDM3IDMxMy42NjY5OTIgMjExLjAyNTM5MSBDIDMxMy42NjY5OTIgMTM3LjQwMjM0NCAyODEuMjY0NjQ4IDY3LjQ3MDcwMyAyMjQuOTcwNzAzIDE5Ljk5NTExNyAiIHRyYW5zZm9ybT0ibWF0cml4KDAuMDM4MDk1MiwwLDAsMC4wMzgwOTUyLDAsMCkiLz4KPC9nPgo8L3N2Zz4K)](https://app.shopsync.aadish.dev) ![CodeRabbit Pull Request Reviews](https://img.shields.io/coderabbit/prs/github/ASDev-Official/shopsync?utm_source=oss&utm_medium=github&utm_campaign=ASDev-Official%2Fshopsync&labelColor=171717&color=FF570A&link=https%3A%2F%2Fcoderabbit.ai&label=CodeRabbit+Reviews) [![Translation status](https://hosted.weblate.org/widget/asdev-shopsync/svg-badge.svg)](https://hosted.weblate.org/engage/asdev-shopsync/)
## 📱 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 [//]: # "## 📱 Screenshots" [//]: # [//]: # '
' [//]: # " " [//]: # " " [//]: # ' ' [//]: # ' ' [//]: # ' ' [//]: # " " [//]: # "
" [//]: # "
" ## 🌐 Translation ✨ We use [Weblate](https://weblate.org)! To make ShopSync available in multiple languages, contribute to our [Weblate](https://hosted.weblate.org/engage/asdev-shopsync/) [![Translation status](https://hosted.weblate.org/widget/asdev-shopsync/horizontal-auto.svg)](https://hosted.weblate.org/engage/asdev-shopsync/) ## 🛠️ 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 ```bash git clone https://github.com/aadishsamir123/asdev-shopsync.git cd asdev-shopsync ``` 2. Install dependencies ```bash 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](https://firebase.google.com/docs/flutter/setup?platform=android) 4. Run the app ```bash 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](LICENSE) file for details. ## Code Coverage (Codecov) [![codecov](https://codecov.io/gh/ASDev-Official/shopsync/graph/badge.svg?token=R2HCGDT03G)](https://codecov.io/gh/ASDev-Official/shopsync) [![](https://codecov.io/gh/ASDev-Official/shopsync/graphs/sunburst.svg?token=R2HCGDT03G)](https://codecov.io/gh/ASDev-Official/shopsync) [![](https://codecov.io/gh/ASDev-Official/shopsync/graphs/tree.svg?token=R2HCGDT03G)](https://codecov.io/gh/ASDev-Official/shopsync) [![](https://codecov.io/gh/ASDev-Official/shopsync/graphs/icicle.svg?token=R2HCGDT03G)](https://codecov.io/gh/ASDev-Official/shopsync) ## FOSSA [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FASDev-Official%2Fshopsync.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2FASDev-Official%2Fshopsync?ref=badge_large)