https://github.com/codedbyaman/movie-app
a modern, beautiful Android app built with Jetpack Compose and Material 3, showcasing popular movies and trailers using the TMDb API. Search, explore, and favorite your picks — all in a smooth, intuitive interface powered by ExoPlayer, Retrofit, and Coil.
https://github.com/codedbyaman/movie-app
android compose-ui
Last synced: 2 months ago
JSON representation
a modern, beautiful Android app built with Jetpack Compose and Material 3, showcasing popular movies and trailers using the TMDb API. Search, explore, and favorite your picks — all in a smooth, intuitive interface powered by ExoPlayer, Retrofit, and Coil.
- Host: GitHub
- URL: https://github.com/codedbyaman/movie-app
- Owner: codedbyaman
- Created: 2025-04-11T19:39:17.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-17T11:22:06.000Z (about 1 year ago)
- Last Synced: 2025-04-19T13:59:25.427Z (about 1 year ago)
- Topics: android, compose-ui
- Language: Kotlin
- Homepage:
- Size: 2.19 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎬 Movie Trailer App
A beautiful Jetpack Compose app that displays popular movies using [The Movie Database (TMDb)](https://www.themoviedb.org/) API. Users can watch trailers, search movies, and mark favorites — all with a Material 3 UI.
---
## ✨ Features
- 🔥 Browse trending/popular movies
- 🔍 **Search** by movie title
- 🎥 Watch trailers via embedded **YouTube** or **ExoPlayer**
- ❤️ Mark/unmark movies as **favorites**
- 💾 Persistent favorites using SharedPreferences (DataStore optional)
- 🎨 Fully styled with **Material 3** and dark theme
- 📦 Built using **Jetpack Compose**, **Retrofit**, **Coil**, and **ExoPlayer**
---
## 📸 Screenshots
_Add your screenshots here!_
---
## 🛠️ Tech Stack
- **Jetpack Compose** UI
- **Material 3** Design Components
- **Retrofit2** + **Gson** – API calls
- **Coil** – image loading
- **ExoPlayer** – in-app video playback
- **SharedPreferences** – persistent favorites
- **Navigation Compose** (optional)
- **TMDb API** – movie data
---
## 🔑 Setup Instructions
1. Get a free API key from [TMDb](https://www.themoviedb.org/settings/api)
2. Open the project in Android Studio
3. In `MovieViewModel.kt`, replace:
```kotlin
private val apiKey = "YOUR_API_KEY"