Flutter Movie

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

            

            

✨ Features

• 🎞 Now Playing, Popular, Top Rated & Upcoming movie sections
• 🔍 Movie Detail Page
• 🎯 Recommended Movies
• 🔍 Search Movies
• 👥 Artist List
• 🧾 Artist Detail Page
• 📃 Pagination (infinite scroll)
• 🔄 Bottom Navigation
• 🧭 Declarative Routing with GoRouter
• 🧱 Clean Architecture (Presentation / Domain / Data)
• 🧪 Riverpod State Management
• 🌐 Network layer using Dio with Logging
• 🚀 Smooth UX with loading indicators

Architecture

Fig. Clean Architecture

Project Directory

flutter_movie_clean_architecture/
├── lib/
│   ├── core/
│   │   ├── config/
│   │   │   └── app_constant.dart
│   │   ├── network/
│   │   │   └── dio_provider.dart
│   │   └── utils/
│   │       └── utils.dart
│   ├── features/
│   │   └── 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
│   ├── 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

Run the app

flutter run

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.
• Logger / DioLogger - Easy and pretty logging package for debugging; use DioLogger to log Dio HTTP requests and responses.

👨 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.