🎬 Cinexa

Cinexa is a modern Android application for discovering movies, TV shows, and actors. Users can explore content, add favorites, and easily access content with detailed search and filtering options.

---

📌 Development

The project’s active development and version control history were primarily managed on Bitbucket.
This GitHub repository contains a migrated version of the codebase for portfolio and showcase purposes,
therefore the commit count here is lower than the actual development activity.

---

🌟 Purpose of the App

Cinexa allows users to view movies, TV shows, and actors.
Users can:

• Explore movies and TV shows
• Mark their favorite content
• Check actor profiles
• Sort content by categories, popularity, trending, or top rated

---

⚙️ Technologies

Cinexa is developed using modern Android development techniques and popular libraries:

• Language: Kotlin
• UI: Jetpack Compose
• Dependency Injection: Hilt & Koin
• Networking & API: Retrofit
• Image Loading: Coil
• Data Management & Pagination: Room + Paging 3
• Architecture: MVVM (Model-View-ViewModel)
• Project Structure: Clean Architecture (Domain, Data, Presentation layers)

---

📸 Screenshots

🎬 Movie

📺 Serie Screens

👤 Person Screens

⭐ Favorite Screens

⚙️ Settings Screens

---

🛠️ Features

🔎 General Features

• Movie & TV show lists: filter by popular, trending, and top rated content
• Detailed search: advanced search bar on the movie screen
• Sort by category: filter content by genre or category
• Grid view: display content in 2-column or 3-column grids
• Add to favorites: movies, TV shows, and actors
• Theme Support: Dark Mode and Light Mode
• Multilingual Support: Interface available in English, Turkish, Spanish, and German

🎥 Movie Detail Screen

• View detailed information about movies (title, genre, release date, rating, etc.)
• Watch trailers
• Share movies with others
• View cast and crew

📺 TV Show Detail Screen

• View detailed information about TV shows (title, seasons, genre, rating, etc.)
• Watch trailers
• Share TV shows with others
• View cast and crew

👤 Person Detail Screen

• View detailed biography of actors/actresses
• See movies and TV shows they starred in
• Add to favorites and follow

---

🚀 Getting Started

Requirements

• Android Studio
• Kotlin 1.5+
• Android 5.0 (API 21)+

🔑 TMDB API Key

This project uses the TMDB API for fetching movie data.
To run the project, you need to add your TMDB API key in a local.properties file:

TMDB_API_KEY=your_api_key_here

Installation

git clone https://github.com/CenkerAydin/CineScope.git