Skip to content

kanav22/compose-commerce-catalog

Repository files navigation

Compose Commerce Catalog

CI License: MIT

Jetpack Compose e-commerce catalog reference app — MVVM, Hilt, modular data layer, and Paparazzi golden tests.


Overview

Product list and detail flows for a fitness apparel catalog. Focus areas: clean architecture, Compose UI, testability, and graceful handling of imperfect API data (missing images, HTML descriptions).

Architecture

Layer Responsibility
UI Compose screens, navigation, design tokens
ViewModel UI state, user actions, repository orchestration
Data Repositories, deserialization, mock/CDN data sources
DI Hilt modules for repositories and services

Stack: Kotlin · Jetpack Compose · Hilt · Navigation Compose · Coil · Gson · Timber · Paparazzi

Features

  • Product list with title, price, color, and image handling (placeholder on failure)
  • Product detail with HTML description parsing
  • Enum-driven product state labels
  • Golden snapshot tests for key screens

Getting Started

Prerequisites

  • Android Studio Hedgehog or newer
  • JDK 17+
  • Android SDK 34

Build & Run

./gradlew assembleDebug
./gradlew installDebug

Tests

./gradlew testDebugUnitTest    # unit, Compose UI, and Paparazzi golden tests

CI

GitHub Actions runs unit tests and assembleDebug on every push and pull request to main.

Screenshots

Product list Product detail Product detail variant

Roadmap

  • Product search and filters (type, price range)
  • Wishlist and basket flows
  • Room/local cache for offline browsing
  • Expanded accessibility coverage

License

MIT — see LICENSE.

About

Jetpack Compose e-commerce catalog — MVVM, Hilt, Paparazzi golden tests, CI

Topics

Resources

License

Stars

0 stars

Watchers

1 watching

Forks

Packages

 
 
 

Contributors

Languages