https://github.com/aryanbhargav/mangashelfapp

MangaShelf App is to help Manga Fans to explore and track their favourite manga.It is an Android application built using Jetpack Compose, Coroutines for Async Operations, Hilt for DI, Room Database for local storage, and Retrofit for network communication integrating a clean architecture pattern with MVVM.
https://github.com/aryanbhargav/mangashelfapp

clean-architecture coil-image-loader coroutines coroutines-android flow hilt-dependency-injection jetpack-compose kotlin mvvm-architecture retrofit2-kotlin room-database viewmodel

Last synced: 4 months ago
JSON representation

MangaShelf App is to help Manga Fans to explore and track their favourite manga.It is an Android application built using Jetpack Compose, Coroutines for Async Operations, Hilt for DI, Room Database for local storage, and Retrofit for network communication integrating a clean architecture pattern with MVVM.

• Host: GitHub
• URL: https://github.com/aryanbhargav/mangashelfapp
• Owner: Aryanbhargav
• Created: 2025-02-24T18:46:36.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2025-02-24T19:35:26.000Z (4 months ago)
• Last Synced: 2025-02-24T20:30:43.130Z (4 months ago)
• Topics: clean-architecture, coil-image-loader, coroutines, coroutines-android, flow, hilt-dependency-injection, jetpack-compose, kotlin, mvvm-architecture, retrofit2-kotlin, room-database, viewmodel
• Language: Kotlin
• Homepage:
• Size: 155 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# MangaShelf

## App Previews









## Setup Process

1. **Download the ZIP**  

   - Go to the [GitHub repository]().  

   - Click on the **"Code"** button and select **"Download ZIP"**.  

   - Extract the downloaded ZIP file to your desired location.  

2. **Import into Android Studio**  

   - Open **Android Studio**.  

   - Click on **"Open"**.  

   - Navigate to the extracted folder and select it.  

   - Wait for the project to sync and build.  

3. **Run the App**  

   - Connect an emulator or physical device.

   - Run the project from 'main' branch

   - Click on the **Run** button ▶️ to launch the app.  

## Project Architecture

MangaShelf follows **Clean Architecture** with the **MVVM** design pattern. The project is structured into three main layers:  

1. **Data Layer**  

   - Handles data operations from **Network (Retrofit)** and **Local Database (Room)**.  

2. **Domain Layer**  

   - Contains repository implementations to abstract data sources.  

3. **UI Layer**  

   - Built with **Jetpack Compose** and consists of **Composables** and **ViewModel** to manage UI state.  

### Tech Stack

- **Networking** → Retrofit  

- **Local Storage** → Room  

- **Dependency Injection** → Hilt  

- **Async Operations** → Kotlin Coroutines & Flow  

- **UI Framework** → Jetpack Compose  

- **Image Loading** → Coil  

- **Lifecycle Management** → ViewModel