My Movies App

A fully functional, modern, yet simple example of a movie app. Remote data source is popular TheMovieDB API. The project uses latest methods and best practices as much as possible from architecture to UI design patterns.

Screenshots

Soon to be added..

Status

No further development. It was meant to test the API..

Download

Go to the Releases to download the latest APK (Demo Api Key included).

Build And Run

1. Get a free API Key at TheMovieDB.com
2. Clone the repo

   git clone https://github.com/boy12hoody/MyMovies.git

3. From Android Studio, select Import Project, then select the root folder of the cloned repository.
4. Click Make Project to build the app and download all the required dependencies.
5. Replace API key with yours in util/Constants.kt

   const val API_KEY = "Paste_Your_Key_Here"

6. Click Run app to install the app on your device or emulator.

🛠 Tech stack & Open-source libraries

• Kotlin - First class and official programming language for Android development.
• Coroutines - For asynchronous and more..
• Flow - A cold asynchronous data stream that sequentially emits values and completes normally or with an exception.
• Parcelize - Parcelable implementation generator.
• TheMovieDB API - Famous Movies and TV database.
• Retrofit 2 - A type-safe HTTP client for Android and the JVM.
• Moshi + Codegen - A modern JSON library for Kotlin and Java.
• Chucker - An HTTP inspector for Android & OkHTTP.
• Coil - An image loading library for Android backed by Kotlin Coroutines.
• Android Architecture Components - Collection of libraries that help you design robust, testable, and maintainable apps.
  • Jetpack
    • Navigation - Navigation component designed for apps that have one main activity with multiple fragment destinations.
    • LiveData - Data objects that notify views when the underlying database changes.
    • Lifecycle - Handling lifecycles with lifecycle-aware components.
    • ViewModel - Stores UI-related data that isn't destroyed on UI changes.
    • AndroidViewModel - Application context aware ViewModel
    • 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-Dagger - Standard library to incorporate Dagger dependency injection into an Android application.
  • Hilt-ViewModel - DI for injecting ViewModel.
• Material Components for Android - Modular and customizable Material Design UI components for Android.
• Shimmer Effect - An easy way to add a shimmer effect to any view.

Architecture

This app uses MVVM (Model View View-Model) architecture.

Package Structure

uz.boywonder.mymovies          # Root Package
.
├── adapters                    # Adapters for RecyclerView
|
├── data                        # Data sources and repositories.
│   └── network                 # Remote Data Handler (API)
│
├── models                      # Model classes
|
├── di                          # Dependency Injection
|
├── ui                          # View layer - Activity / Fragments / ViewModels
│
└── utils                       # Utility Classes

Contact

If you have questions or need any help, contact me on

License

   Copyright (c) 2021 Ismatov Xurshid
   
   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.