Skip to content

rajatt04/Creamie

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

70 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🍨 Creamie Wallpaper App

A modern, fast, and beautiful Jetpack Compose showcase app for downloading and setting wallpapers, demonstrating Android UI development with declarative patterns and clean architecture.

Creamie highlights the best practices of Kotlin + Jetpack Compose + Material3 by implementing a sleek Glassmorphism UI, robust network caching, pagination, and reusable design patterns.


πŸ“₯ Download APK

⚑ Fast β€’ 🎯 Minimal β€’ πŸ“± Built with Kotlin & MVI


πŸš€ Features

  • Built entirely with Jetpack Compose (no legacy XML)
  • Material Design 3 & Glassmorphism theming for a premium look
  • Infinite Scrolling with Paging 3
  • Dynamic Colors using Palette API to extract colors from images
  • Offline Caching backed by Room Database
  • Background Operations with WorkManager for downloading and setting wallpapers
  • Home Screen Widgets built with Glance AppWidget
  • Clean Architecture with Hilt Dependency Injection and ViewModel-driven UI
  • Sleek Animations using Compose Animation and Lottie

πŸ“± App Screenshots

App Screenshots

Below are some screenshots of the Creamie application showcasing its features and user interface:

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4
Image1 Image2 Image3 Image4
Screenshot 5 Screenshot 6 Screenshot 7 Screenshot 8
Image5 Image6 Image7 Image8

πŸ› οΈ Tech Stack & Architecture

  • Language: Kotlin
  • UI & Animations: Jetpack Compose, Compose Material3, Coil (Image Loading), Lottie, Glance (Widgets)
  • Architecture: MVI/MVVM, State Hoisting, Clean Architecture
  • Dependency Injection: Dagger Hilt
  • Network & Data: Retrofit, OkHttp, Paging 3
  • Local Storage: Room Database, Preferences DataStore
  • Concurrency & Background Tasks: Kotlin Coroutines, Flow, WorkManager
  • Testing: JUnit, MockK, Turbine
  • Debugging: LeakCanary

πŸ“¦ Getting Started

To get a local copy up and running, follow these simple steps:

  1. Clone the repo

    git clone https://github.com/rajatt04/Creamie.git
  2. Setup Pexels API Key

    • Create a file named local.properties in the root directory if it doesn't exist.
    • Add your Pexels API key to the file:
      PEXELS_API_KEY="your_api_key_here"
  3. Open in Android Studio

    • Open the project in the latest stable version of Android Studio with Compose support.
  4. Build & Run

    • Sync the Gradle project and run it on an emulator or device running Android 8.0 (API 26+) or higher.

🀝 Contributing

Contributions and suggestions are warmly welcome! Simply fork the repo, create a new branch, and submit a pull request.


πŸ“„ License

This project is licensed under the MIT License β€” see the LICENSE file for details.


πŸŽ‰ Why β€œCreamie”?

Because this app is as smooth, delightful, and modern as your favorite ice cream flavor. Jetpack Compose never felt this sweet! 🍦

About

🍨 Jetpack Compose wallpaper app β€” MVI architecture, Hilt DI, Glance Widgets & Glassmorphism. ⭐ Star it. Fork it. Ship it.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages