Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dinesh2510/tmdb-movie-app-jetpack-compose

The TMDB Movie App is an Android app built using modern tech like Jetpack Compose, TMDB API, Retrofit, and MVVM. It allows users to explore movie categories, view detailed information, and manage wishlists. The app uses Paging 3 for smooth data loading and Room Database for wishlist management, ensuring a fast, seamless experience
https://github.com/dinesh2510/tmdb-movie-app-jetpack-compose

android dagger-hilt jetpack-compose jetpack-compose-tutorial kotlin kotlin-android kotlin-coroutines mvvm navigation-compose paging-3 retrofit room-database tmdb-api tmdb-api-integration tmdb-movie-app tmdbapi

Last synced: 8 days ago
JSON representation

Host: GitHub
URL: https://github.com/dinesh2510/tmdb-movie-app-jetpack-compose
Owner: Dinesh2510
Created: 2024-09-08T07:36:18.000Z (25 days ago)
Default Branch: main
Last Pushed: 2024-09-08T08:02:49.000Z (25 days ago)
Last Synced: 2024-09-26T00:02:47.037Z (8 days ago)
Topics: android, dagger-hilt, jetpack-compose, jetpack-compose-tutorial, kotlin, kotlin-android, kotlin-coroutines, mvvm, navigation-compose, paging-3, retrofit, room-database, tmdb-api, tmdb-api-integration, tmdb-movie-app, tmdbapi
Language: Kotlin
Homepage: https://www.pixeldev.in/
Size: 14.3 MB
Stars: 2
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# TMDB Movie App with Jetpack Compose & TMDB API 🎬🎥

Welcome to the **TMDB Movie App**! This app showcases movies from the [TMDB API](https://www.themoviedb.org/documentation/api) while leveraging the power of modern Android development with **Jetpack Compose** and other cutting-edge libraries. 🚀

## Screenshots 📸
| Home Screen | Genres List | Now Playing Movies |
| --- | --- | --- |
| ![Screenshot 1](1.png) | ![Screenshot 2](2.png) | ![Screenshot 3](6.png) |

| Movie Details | Search Movies | Wishlist |
| --- | --- | --- |
| ![Screenshot 4](3.png) | ![Screenshot 5](5.png) | ![Screenshot 6](4.png) |

### 💡 **Technologies Used:**
- ⚛️ **Jetpack Compose** – Modern UI Toolkit
- 🎬 **TMDB API** – Fetch the latest movies, genres, and more!
- 🔗 **Retrofit** – For seamless network calls
- 🏛️ **MVVM Architecture** – Clean, maintainable code structure
- 🛡️ **Dagger-Hilt** – Efficient dependency injection
- 📜 **Paging 3** – Effortless pagination for movie listings
- 💾 **Room Database** – Save and manage your Wishlist
- 🧭 **Navigation Compose** – Smooth navigation experience

## How It Works 💻

1. **Home Screen**: The app starts with an automatic sliding banner featuring the latest movies. Below that, it shows a genres listing, followed by multiple movie sections like "Now Playing", "Popular Movies", "Discover", and "Upcoming Movies".
2. **Genres Listing**: Each genre features a scrollable list of movies displayed using **LazyColumn** and **Paging 3** for seamless pagination.
3. **Movie Details**: Click on a movie to see details like its name, description, language, rating, and more. You’ll also see related movies in the same genre.
4. **Search**: Use the search option to find any movie directly from the server.
5. **Wishlist**: Add your favorite movies to the wishlist using **Room Database** and swipe to remove them easily.

## Libraries Used 📚
- **Jetpack Compose**: Modern UI toolkit for building native Android UIs.
- **TMDB API**: Provides access to movies, TV shows, and cast information.
- **Retrofit**: Type-safe HTTP client for Android and Java.
- **MVVM Architecture**: Separates UI, business logic, and data management for easy maintainability.
- **Dagger-Hilt**: Reduces the boilerplate of manual dependency injection.
- **Paging 3**: Handles large data sets by loading content in chunks.
- **Room Database**: Local persistence for saving favorite movies.
- **Navigation Compose**: Handles app navigation in a declarative way.

## How to Run 🔧

1. Clone the repository:
```bash
git clone https://github.com/Dinesh2510/TMDB-Movie-App-Jetpack-Compose.git
```
2. Open the project in Android Studio.
3. Add your **TMDB API Key** in the `local.properties` file:
```properties
tmdbApiKey=YOUR_API_KEY
```
4. Build and run the app on an Android emulator or device.

## Contributing 🤝
Feel free to submit pull requests or open issues to improve the app. Contributions are always welcome!

## License 📜
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---

Thanks for checking out the **TMDB Movie App**! Don't forget to ⭐ the repository if you find it helpful. 😊

---

Made with ❤️ by [Dinesh Chavan](https://github.com/Dinesh2510)

---