AndroidFlavoursApp

Android application written in Kotlin that utilizes the API TMDB movies to display a list of movies. It implements different variants (flavors) to cater to various user needs and preferences.

Objective

Learn how to use and manage variants in an Android application that share common code, and handle the differences between the application's variants.

Packages 🗃️

• Main
• Free (flavor)
• Paid (flavor) - The name is descriptive only; you don't have to pay anything to use it! :D

Requirements ⚙️

• Java jdk 17
• Android sdk 34

Important: Don't forget to add your API key in the local.properties file in the project, like this:

    MY_API_KEY = "Replace-this-text-with-your-key"

To select a variant and work on it, you can do so from the project view, which displays all the packages. The Android view will only show the default selected variant. To display the packages and resources of a specific variant, select it from the "Build Variants" tab in Android Studio.

Download apk demo 📂 click here

Project status

It was used 🔧

• Arquitectura MVVM
• Android-splash-screen
• API TMDB movies
• Clean code
• Data-store-preferences
• Glide
• Dagger Hilt
• Kotlin coroutines
• Lottie-Animations
• LiveData
• Navigation-component
• OkHttp
• Retrofit
• Safe Args
• Shimmer layout
• ViewModel

Features 📝

• Free(flavor)
  • Displays movies (recent, popular, top-rated, etc.)
  • Ability to filter by genres
  • Movie detail view
  • Movie search Settings
• Paid(flavor)
  • All content from the Free variant
  • Login to TMDb Movies
  • User account favorites list
  • User account watchlist
  • Add to favorites list
  • Add to watchlist

Screenshots 🖼️

Free(splash screen)	Paid(splash screen)	Free
Paid	Free/Paid	Free/Paid
Free/Paid	Paid	Paid
Paid	Paid

License

The MIT License (MIT)

Copyright (c) 2024 Barry Zea H.

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.