🎬 The Moviz App

A modern Android application built with Jetpack Compose that fetches popular movies from TMDB API and caches them locally using Room Database for offline access.

---

📸 Preview

---

✨ Features

• 🎬 Browse popular movies from TMDB
• 💾 Offline caching with Room Database
• 🖼️ Movie posters powered by Coil
• ⭐ Movie ratings
• 📅 Release date
• 📝 Movie overview
• ⚡ Built with Jetpack Compose
• 🔄 Automatic online/offline data handling
• 🏛️ Clean MVVM architecture

---

🛠️ Tech Stack

• Kotlin
• Jetpack Compose
• Material 3
• MVVM Architecture
• Retrofit
• Gson Converter
• Room Database
• Kotlin Coroutines
• Coil
• ViewModel
• State Management

---

📂 Project Structure

app
├── core
│   └── App.kt
├── data
│   ├── local
│   │   ├── dao
│   │   └── database
│   ├── remote
│   │   ├── api
│   │   └── network
│   ├── model
│   └── repository
├── presentation
│   ├── component
│   └── screen
├── ui
├── viewmodel
└── MainActivity.kt

---

🚀 Getting Started

1. Clone the repository

git clone https://github.com/artistic-programmer/TheMovizApp.git

2. Open the project in Android Studio

3. Add your TMDB API Key

Create or update your local.properties file:

TMDB_API_KEY=YOUR_API_KEY

The project automatically reads the API key using BuildConfig.

4. Build and Run

---

📦 Libraries Used

• Retrofit
• Gson Converter
• Room Database
• Kotlin Coroutines
• Coil
• Lifecycle ViewModel
• Jetpack Compose
• Material 3

---

📈 Future Improvements

• 🔍 Search Movies
• 🎬 Movie Details Screen
• ❤️ Favorites
• 🎭 Genre Filtering
• 📄 Pagination
• 🌙 Dark Mode
• 🎞️ Trailer Support

---

👨‍💻 Author

Artistic Programmer

GitHub: https://github.com/artistic-programmer

---

⭐ Support

If you found this project helpful, consider giving it a ⭐ on GitHub.