https://github.com/hieuwu/android-groceries-store

A Groceries Store app with basic order flow. 🍕 Help you learn modern Android development skills in real production environment. ❤️
https://github.com/hieuwu/android-groceries-store

android android-development android-jetpack-compose hacktoberfest jetpack-compose mvvm-architecture supabase supabase-client

Last synced: about 1 month ago
JSON representation

A Groceries Store app with basic order flow. 🍕 Help you learn modern Android development skills in real production environment. ❤️

• Host: GitHub
• URL: https://github.com/hieuwu/android-groceries-store
• Owner: hieuwu
• License: mit
• Created: 2021-04-22T15:49:49.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-09-18T19:32:18.000Z (about 2 months ago)
• Last Synced: 2024-09-28T10:42:47.009Z (about 2 months ago)
• Topics: android, android-development, android-jetpack-compose, hacktoberfest, jetpack-compose, mvvm-architecture, supabase, supabase-client
• Language: Kotlin
• Homepage: https://hieuwu.github.io/android-groceries-store/
• Size: 24.9 MB
• Stars: 220
• Watchers: 3
• Forks: 55
• Open Issues: 29
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-list - hieuwu/android-groceries-store - A Groceries Store app with basic order flow. 🍕 Help you learn modern Android development skills in real production environment. ❤️ (Kotlin)

README

        
 🚀 Groceries Store


 [![Android CI](https://github.com/hieuwu/android-groceries-store/actions/workflows/app-build.yml/badge.svg?branch=main)](https://github.com/hieuwu/android-groceries-store/actions/workflows/app-build.yml)

[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=hieuwu_android-groceries-store&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=hieuwu_android-groceries-store)

![Groceries Store](https://user-images.githubusercontent.com/43868345/233767546-ba25566b-7926-4140-82fe-12346a1f357e.png)



[![SonarCloud](https://sonarcloud.io/images/project_badges/sonarcloud-black.svg)](https://sonarcloud.io/summary/new_code?id=ARK-Builders_arklib-android)

[Download on Google Play Store](https://play.google.com/store/apps/details?id=com.hieuwu.groceriesstore)

## 👋 About

Groceries Store is a project to help people order grocery online. The main purpose of this project is to demonstrate modern Android development skills in real production environment, reduce the learning curve when jump into Android development world.

## 🎨 UI Design & Architecture



**Design**

- [Groceries Store Design](https://www.figma.com/file/exhlJtkLIcHvfxd8SDja3T/Online-Groceries-App-UI-(Community)?node-id=1%3A2)

- Background vector created by freepik - www.freepik.com

- Food vector created by terdpongvector - www.freepik.com

**Architecture**

- [Use Case](https://proandroiddev.com/why-you-need-use-cases-interactors-142e8a6fe576)

- [Clean Architecture](https://medium.com/@dmilicic/a-detailed-guide-on-developing-android-apps-using-the-clean-architecture-pattern-d38d71e94029)

- [MVVM Architecture](https://medium.com/swlh/understanding-mvvm-architecture-in-android-aa66f7e1a70b)

## 🛠️ Libraries

- [Glide](https://github.com/bumptech/glide) - Loading images.

- [Timber](https://github.com/JakeWharton/timber) - Logging.

- [Retrofit2](https://github.com/square/retrofit) - Construct the REST APIs and paging network data.

- [Moshi](https://github.com/square/moshi/) - A modern JSON library for Kotlin and Java.

- [Hilt](https://dagger.dev/hilt/) for dependency injection.

- JetPack

  - Lifecycle - dispose of observing data when lifecycle state changes.

  - ViewModel - UI related data holder, lifecycle aware.

  - Room Persistence - construct a database using the abstract layer.

## ⚙️ Setup

#### Android Studio

Android Studio Bumblebee or later

SDK 23 or later

#### Supabase

See [Supabase Wiki](https://github.com/hieuwu/android-groceries-store/wiki) 

Database Schema:



## 🎯 Find this repository useful? :heart:

Support it by joining __[stargazers](https://github.com/hieuwu/android-groceries-store/stargazers)__ for this repository. :star: 


Also, __[follow me](https://github.com/hieuwu)__ on GitHub for my next creations! 🤩

## 👨‍💻 Contributors ✨

[![All Contributors](https://img.shields.io/badge/all_contributors-7-orange.svg?style=flat-square)](#contributors-)

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

  

    

      
Saurabh Patel
💻

      
Aditya Gupta
🎨 💻 💡

      
Dmitriy
💻

      
Devendra Varma
💻

      
Amartya
🎨

      
NLC
🎨 💻

      
Fredrik Henricsson
💻

    

  

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!