TMDB - Flutter Movie App 🎥

TMDB is a Flutter mobile application powered by the TMDB public APIs. The app allows users to:

• Search for movies.
• View movie details (about, cast, reviews).
• Explore movie categories like "Top Rated" and "Popular."
• Add movies to their favorites list.

You can find the figma design here

Features ✨

• Search Movies: Instantly search for your favorite movies by title.
• Movie Details: View comprehensive details about movies, including cast, reviews, and descriptions.
• Category Browsing: Explore movies by categories such as Top Rated, Popular, Upcoming, and more.
• Favorites Management: Mark movies as favorites and access them later.
• Offline Support: Access saved favorites even without an Internet connection.

Technologies & Packages Used 📦

• BLoC: For state management.
• Hive: For local storage.
• Dio: For HTTP requests.
• Cached Network Image: For efficient image loading and caching.

Setup Instructions ⚙️

1. Clone the Repository

git clone https://github.com/Hiwa-Shaloudegi/TMDB.git
cd TMDB

2. Set Up API Key

This project requires an API access token from TMDB. To configure it:

1. Create a .env file in the root directory by copying .env.example:

cp .env.example .env

2. Open .env and update it with a valid API access token:

API_ACCESS_TOKEN=your_api_access_token_here

3. Install Dependencies

flutter pub get

4. Run the App

flutter run

Screenshots 📸