WallUp ⛰

Wallpaper finder and downloader app Demonstrate the Jetpack Compose UI using Unsplash API Made with ❤️ by Enes

UI Design 🎨

Thanks to Rian Hamidjoyo for Wallpaper App UI Design

Screens 🖼

Home Screen	Detail Screen

Bookmark Screen	Collection Screen

Prerequisites

• API Key

To run the application, an API key from Unsplash should be supplied.

inside local.properties file add this line and Rebuild project. apiKey="Your API Key Here"

How to store API key? - Stackoverflow

Architecture 🧰

• Single Activity No Fragment
• MVVM Pattern

View: Renders UI and delegates user actions to ViewModel

ViewModel: Can have simple UI logic but most of the time just gets the data from UseCase.

UseCase: Contains all business rules and they written in the manner of single responsibility principle.

Repository: Single source of data. Responsible to get data from one or more data sources.

For more information you can check Guide to app architecture

Libraries 🛠

• Kotlin - First class and official programming language for Android development.
• Ktor Client - Ktor includes a multiplatform asynchronous HTTP client, which allows you to make requests and handle responses, extend its functionality with plugins (formerly known as features), such as authentication, JSON serialization, and so on. In this topic, we'll take an overview of the client - from setting it up to making requests and installing plugins.
• Jetpack Compose - Jetpack Compose is Android’s modern toolkit for building native UI.
• Coroutines - For asynchronous and more..
• Android Architecture Components - Collection of libraries that help you design robust, testable, and maintainable apps.
  • Flows - Data objects that notify views when the underlying database changes.
  • ViewModel - Stores UI-related data that isn't destroyed on UI changes.
  • Room - Database Library
• Compose Destinations - A KSP library that processes annotations and generates code that uses Official Jetpack Compose Navigation under the hood. It hides from you the non-type-safe and boilerplate code you would otherwise have to write.
• Material Components for Android
  • Modular and customizable Material Design UI components for Android.
• Dagger - Hilt - Dependency Injection Framework
• Coil - Image loader library.

Package Structure 🗂

.
.
.
├── di                    # Hilt Dependency Injection
├── feature_bookmark
├── feature_collection
├── feature_detail
├── feature_home
├── feature_splash
|    ├── data             # DTOs and repositories implementation
|    |
|    ├── domain           # Models, repositories and use cases
|    | 
|    └── presentation     # UI Components
├── ui                    
|    ├── theme            # Compose Theme
|    |               
|    └── animation        # Animation Utils
|
├── utils                 # Useful classes
|
└── WallUpApp.kt          # @HiltAndroidApp

Contribute 🤝

If you want to contribute to this app, you're always welcome!

License 📄

Copyright 2022 Enes-Kayiklik

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.