Flutter Movie

Flutter Movie App built with Riverpod, Clean Architecture, and GoRouter that showcases movies and TV series fetched from TMDB API. It includes now playing, popular, top-rated, and upcoming Movies, TV series and Celebrity with support for pagination, search, and detailed views.

✨ Features

Movies

• 🎞 Now Playing, Popular, Top Rated & Upcoming movie sections
• 🔍 Movie Detail Pages with Cast & Crew
• 🎯 Recommended Movies
• 🔍 Search Movies
• 👤 Artist/Actor Detail Page with navigation from movie cast
• ❤️ Favorite Movies (saved locally using Hive database)

TV Series

• 📺 Airing Today, On The Air, Popular & Upcoming TV series sections
• 🔍 TV Series Detail Pages with Cast & Crew
• 🎯 Recommended TV Series
• 🔍 Search TV Series
• 👤 Artist/Actor Detail Page with navigation from TV series cast
• ❤️ Favorite TV Series (saved locally using Hive database)

Celebrity

• 🌟 Popular and Trending Celebrities/Persons sections
• 🔍 Celebrity Search functionality
• 👤 Celebrity Detail Page with navigation from movie/tv cast
• ❤️ Favorite Celebrities (saved locally using Hive database)

Common Features

• 📃 Pagination (infinite scroll)
• 🔄 Bottom Navigation
• 🌐 Multi-language Support with Localization (English & Spanish)
• 🧭 Declarative Routing with GoRouter
• 🧱 Clean Architecture (Presentation / Domain / Data)
• 🧪 Riverpod State Management
• 🌐 Network layer using Dio with Logging
• 🚀 Smooth UX with loading indicators
• ❤️ Favorite Management with Local Storage (Hive)

Architecture

Fig. Clean Architecture

Project Directory

flutter_movie_clean_architecture/
├── lib/
│   ├── core/
│   │   ├── config/
│   │   │   └── app_constant.dart
│   │   ├── network/
│   │   │   └── dio_provider.dart
│   │   ├── utils/
│   │   │   └── utils.dart
│   │   └── hive/
│   │       ├── favorite_model.dart
│   │       ├── favorite_model.g.dart
│   │       └── hive_helper.dart
│   ├── features/
│   │   ├── celebrity/
│   │   │   ├── data/
│   │   │   │   ├── datasources/
│   │   │   │   │   └── celebrity_remote_data_source.dart
│   │   │   │   ├── models/
│   │   │   │   │   ├── person_model.dart
│   │   │   │   │   └── person_list_response.dart
│   │   │   │   └── repositories/
│   │   │   │       └── celebrity_repository_impl.dart
│   │   │   ├── domain/
│   │   │   │   ├── entities/
│   │   │   │   │   └── person.dart
│   │   │   │   ├── repositories/
│   │   │   │   │   └── celebrity_repository.dart
│   │   │   │   └── usecases/
│   │   │   │       ├── get_popular_persons.dart
│   │   │   │       ├── get_trending_persons.dart
│   │   │   │       └── search_persons.dart
│   │   │   └── presentation/
│   │   │       ├── pages/
│   │   │       │   ├── celebrity_main_page.dart
│   │   │       │   ├── celebrity_search_page.dart
│   │   │       │   ├── popular_persons_page.dart
│   │   │       │   └── trending_persons_page.dart
│   │   │       ├── providers/
│   │   │       │   └── celebrity_provider.dart
│   │   │       └── widgets/
│   │   │           └── person_card.dart
│   │   ├── movie/
│   │   │   ├── data/
│   │   │   │   ├── datasources/
│   │   │   │   │   └── movie_remote_data_source.dart
│   │   │   │   ├── models/
│   │   │   │   │   ├── movie_detail_model.dart
│   │   │   │   │   ├── movie_model.dart
│   │   │   │   │   └── credit_model.dart
│   │   │   │   └── repositories/
│   │   │   │       └── movie_repository_impl.dart
│   │   │   ├── domain/
│   │   │   │   ├── entities/
│   │   │   │   │   ├── movie.dart
│   │   │   │   │   ├── movie_detail.dart
│   │   │   │   │   ├── credit.dart
│   │   │   │   │   └── artist_detail.dart
│   │   │   │   ├── repositories/
│   │   │   │   │   └── movie_repository.dart
│   │   │   │   └── usecases/
│   │   │   │       ├── get_all_artist_movies.dart
│   │   │   │       ├── get_movie_detail.dart
│   │   │   │       ├── get_movie_credits.dart
│   │   │   │       ├── get_movie_search.dart
│   │   │   │       ├── get_now_playing.dart
│   │   │   │       ├── get_popular.dart
│   │   │   │       ├── get_top_rated.dart
│   │   │   │       ├── get_up_coming.dart
│   │   │   │       ├── get_recommended_movie.dart
│   │   │   │       └── get_artist_detail.dart
│   │   │   └── presentation/
│   │   │       ├── pages/
│   │   │       │   ├── artist_detail_page.dart
│   │   │       │   ├── artist_list_page.dart
│   │   │       │   ├── movie_detail_page.dart
│   │   │       │   ├── movie_main_page.dart
│   │   │       │   ├── now_playing_page.dart
│   │   │       │   ├── popular_page.dart
│   │   │       │   ├── top_rated_page.dart
│   │   │       │   └── up_coming_page.dart
│   │   │       ├── providers/
│   │   │       │   ├── movie_provider.dart
│   │   │       └── widgets/
│   │   │           ├── movie_card.dart
│   │   │           └── movie_search.dart
│   │   ├── tv_series/
│   │   │   ├── data/
│   │   │   │   ├── datasources/
│   │   │   │   │   └── tv_series_remote_data_source.dart
│   │   │   │   ├── models/
│   │   │   │   │   ├── tv_series_detail_model.dart
│   │   │   │   │   ├── tv_series_model.dart
│   │   │   │   │   └── tv_series_credit_model.dart
│   │   │   │   └── repositories/
│   │   │   │       └── tv_series_repository_impl.dart
│   │   │   ├── domain/
│   │   │   │   ├── entities/
│   │   │   │   │   ├── tv_series.dart
│   │   │   │   │   └── tv_series_detail.dart
│   │   │   │   ├── repositories/
│   │   │   │   │   └── tv_series_repository.dart
│   │   │   │   └── usecases/
│   │   │   │       ├── get_airing_today.dart
│   │   │   │       ├── get_on_the_air.dart
│   │   │   │       ├── get_popular_tv_series.dart
│   │   │   │       ├── get_upcoming_tv_series.dart
│   │   │   │       ├── get_tv_series_detail.dart
│   │   │   │       ├── get_tv_series_credits.dart
│   │   │   │       ├── get_recommended_tv_series.dart
│   │   │   │       └── get_tv_series_search.dart
│   │   │   └── presentation/
│   │   │       ├── pages/
│   │   │       │   ├── airing_today_page.dart
│   │   │       │   ├── on_the_air_page.dart
│   │   │       │   ├── popular_tv_series_page.dart
│   │   │       │   ├── tv_series_detail_page.dart
│   │   │       │   ├── tv_series_main_page.dart
│   │   │       │   └── upcoming_tv_series_page.dart
│   │   │       ├── providers/
│   │   │       │   ├── tv_series_provider.dart
│   │   │       └── widgets/
│   │   │           └── tv_series_card.dart
│   │   └── favorites/
│   │       └── favorites_page.dart
│   ├── routing/
│   │   └── app_router.dart
│   └── main.dart
├── ios/
├── screen_shots/
├── test/
├── .flutter-plugins
├── .flutter-plugins-dependencies
├── .gitignore
├── .metadata
├── analysis_options.yaml
└── flutter_movie_clean_architecture.iml

Clone the repository

git clone git@github.com:piashcse/flutter-movie-clean-architecture.git

Install dependencies

flutter pub get

Generate code (build runner)

flutter pub run build_runner build --delete-conflicting-outputs

This command generates code for:

• Freezed models (immutable data classes)
• JsonSerializable (JSON serialization/deserialization)
• Hive adapters (local database models)

Run the app

flutter run

After running the app, you can:

• Browse movies, TV series, and celebrities
• View detailed information about each item
• Save your favorite items using the heart icon on detail pages
• Access your saved favorites through the Favorites tab

Built With 🛠

• Flutter - Google's UI toolkit for building natively compiled applications for mobile, web, and desktop from a single codebase.
• Riverpod - A simple, composable, and testable state management solution for Flutter.
• GoRouter - Declarative routing package for Flutter, designed to work seamlessly with state management and deep linking.
• Dio - A powerful HTTP client for Dart, supporting interceptors, global configuration, FormData, request cancellation, and more.
• Freezed - A code generator for immutable classes that helps with union types/pattern matching in Dart.
• JsonSerializable - Generates code for converting between Dart objects and JSON, making serialization easy.
• Flutter Localizations - Internationalization and localization support for multi-language applications.
• Logger / DioLogger - Easy and pretty logging package for debugging; use DioLogger to log Dio HTTP requests and responses.
• Hive - Lightweight and blazing fast key-value database written in pure Dart.
• Hive Flutter - Extension for Hive that enables Flutter specific features.

👨 Developed By

Mehedi Hassan Piash

License

Copyright 2025 piashcse (Mehedi Hassan Piash)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.