A simple image gallery that fetches data from Lorem Picsum API and builds with MVVM and with a touch of Clean Architecture.
Lorem Picsum: Lorem Picsum provides random or specific uploaded images as placeholders. Developers need to specify the desired image size (width & height) at the end of the request URL. Grayscale and blur effects can be applied to any image.
MVVM Architecture: This guide encompasses best practices and recommended architecture for building robust, production-quality apps.
Conventional Commits: Used Conventional commit messages for committing every activity.
- Use https://picsum.photos to get a list of photos
- The user can tap the photo
- The user can see a full-screen view of the photo
- The user has an infinite scroll on the gallery screen
- The app’s a flavor/scheme can be changed easily so that changing from development API to production API becomes trivial
- Cache images
- Cache API response
- Allow saving photos in JPEG format to the local gallery
- Allow sharing the photo
- Day-Night mode sync with Calendar Time
- Code In-line and Multi-line documents add
- Git Commits describes using Conventional Commit Message Guideline
- Built with Modern Android Development (MAD) practices
- Utilization of clean architecture and SOLID design principles
- Utilized Usecase, Repository pattern for data
- Includes unit tests for Use cases, Repository, ViewModels, API response
- Dependency Injection using Dragger-Hilt
- Util class to reduce common code duplication
- Full app built with Kotlin
- Jetpack Components used
- Main/ Master branch is set for main production branch
- Development Branch is set for all development face
- Room-implementation Branch is for implementing local database
- api-implementation Branch is for API integration
- unit-test-imp Branch is for testing (not fully done)
- ci-cd-pipeline Branch is for creating automation (Plan implement later)
Download the APK file
- Kotlin - First class and official programming language for Android development.
- Coroutines - For asynchronous and thread handling
- Room - FThe Room persistence library provides an abstraction layer over SQLite to allow for more robust database access while harnessing the full power of SQLite.
- Flow - A cold asynchronous data stream that sequentially emits values and completes normally or with an exception.
- Android Architecture Components - Collection of libraries that help you design robust, testable, and maintainable apps.
- LiveData - Data objects that notify views when the underlying database changes.
- ViewModel - Stores UI-related data that isn't destroyed on UI changes.
- ViewBinding - Generates a binding class for each XML layout file present in that module and allows you to more easily write code that interacts with views.
- Dependency Injection
- Hilt - An easier way to incorporate Dagger DI into Android apps.
- Retrofit - A type-safe HTTP client for Android and Java.
- Firebase - Firebase helps build and run successful apps.
- Zoomage - A simple pinch-to-zoom ImageView library for Android with an emphasis on a smooth and natural feel.
- Material Components for Android - Modular and customizable Material Design UI components for Android.
- Lottie - Lottie is a mobile library for Android and iOS that parses Adobe After Effects animations exported as JSON with Bodymovin and renders them natively on mobile!
- Gradle Kotlin DSL - For writing Gradle build scripts using Kotlin.
- MockK - For Mocking and Unit Testing.
- Glide - Glide is a fast and efficient open-source media management and image loading framework for Android that wraps media decoding, memory, and disk caching, and resource pooling into a simple and easy to use interface.
Developed By Md Rashad Tanjim - website: https://rashadtanjim.info/
Copyright (C) 2021 MD RASHAD TANJIM
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.