Skip to content

kaaneneskpc/Shopr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

77 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›οΈ Shopr - Multi-Module Android Shopping App

Android Kotlin Jetpack%20Compose Koin Open%20Source

πŸš€ Shopr is a multi-module Android shopping app built with Jetpack Compose, Kotlin, and a scalable architecture to enhance maintainability and build times. This project is designed to demonstrate best practices in modularization, dependency injection, and UI/UX.


πŸ“Œ Features

  • πŸ“¦ Multi-Module Architecture for improved maintainability.
  • 🎨 Modern UI with Jetpack Compose.
  • πŸ”— Networking powered by Ktor.
  • πŸ“Š State Management using Jetpack ViewModel & LiveData.
  • πŸ—οΈ Dependency Injection via Koin.
  • πŸ“œ Kotlin Serialization for data handling.
  • πŸ› οΈ Unit & UI Testing with JUnit and Espresso.

πŸ—οΈ Project Modules

Core Modules

  • πŸ› οΈ Common - Shared utilities.
  • 🎨 UI - Design system components.
  • 🌐 Network - API handling via Ktor.
  • πŸ’Ύ Data - Repository pattern implementation.
  • βš™οΈ Domain - Business logic and use cases.
  • 🧭 Navigation - Centralized navigation management.
  • πŸ” Testing - Unit & UI testing utilities.

Feature Modules

  • 🏠 Home - Main dashboard.
  • πŸ’³ Cart - Shopping cart.
  • πŸ›’ Orders - Order history.
  • πŸ‘€ Profile (Coming Soon...)

πŸ—οΈ Tech Stack

  • Language: Kotlin 2.0.0 πŸš€
  • Framework: Jetpack Compose 🎨
  • Dependency Injection: Koin πŸ—οΈ
  • Networking: Ktor 🌍
  • Serialization: Kotlinx Serialization πŸ“œ
  • Testing: JUnit, Espresso, Mockito πŸ”¬
  • Build System: Gradle πŸ”§

πŸ“· Screenshoots

Home

Cart

Orders And Profile

Address

Payment


πŸ› οΈ Installation & Setup

Prerequisites

  • JDK 17+
  • Gradle 8.8+

Clone the Repository

git clone https://github.com/yourusername/shopr.git
cd shopr

Run the Project

./gradlew clean build
./gradlew :app:installDebug

πŸš€ Contributing

Contributions are welcome! πŸŽ‰ Feel free to fork the repository and submit a Pull Request with improvements.

Steps to Contribute:

  1. Fork the repo 🍴
  2. Create a new branch πŸš€ (git checkout -b feature-name)
  3. Commit changes 🎯 (git commit -m 'Add feature XYZ')
  4. Push to the branch πŸ“€ (git push origin feature-name)
  5. Open a Pull Request πŸ”₯

πŸ“ License

This project is open-source and available under the MIT License.


Inspired (Credit By)

This repo inspried from furqanullah717


πŸ’‘ Looking for feedback & collaboration! If you're passionate about Android architecture, feel free to connect. πŸš€

About

πŸš€ Shopr is a multi-module Android shopping app built with Jetpack Compose, Kotlin, and a scalable architecture to enhance maintainability and build times. This project is designed to demonstrate best practices in modularization, dependency injection, and UI/UX.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages