This is a Flutter-based mobile application that allows users to explore and discover movies using the Movies API. The app utilizes the BLoC (Business Logic Component) architecture pattern for efficient state management and separation of concerns.
- Browse a vast collection of movies from various genres.
- Search for movies by title, genre, or any other relevant criteria.
- View detailed information about each movie, including plot, release date, duration, and rating.
- Save favorite movies for quick access.
- Get personalized movie recommendations based on user preferences.
- Watch movie trailers and related videos.
- Stay up to date with the latest movie releases and popular movies.
The app follows the BLoC (Business Logic Component) architecture pattern, which ensures clear separation of UI, business logic, and data management. This helps maintain a scalable and maintainable codebase.
The following libraries and technologies are used in this project:
- Flutter: A cross-platform framework for building beautiful native applications.
- BLoC: A state management library that helps separate business logic from UI components.
- Dart: The programming language used to develop Flutter applications.
- HTTP: A library for making HTTP requests to retrieve data from the Movies API.
- Provider: A dependency injection library that allows for the efficient management of dependencies.
- SharedPreferences: A plugin for storing key-value pairs on the device for saving user preferences.
To run this app on your local machine, follow these steps:
-
Ensure that you have Flutter and Dart installed on your system. For installation instructions, refer to the official Flutter documentation: https://flutter.dev/docs/get-started/install
-
Clone this repository using the following command:
git clone https://github.com/dakshdeepHERE/CineHub
-
Navigate to the project directory:
cd CineHub -
Fetch the required dependencies by running the following command:
flutter pub get
-
Connect your device or start the emulator.
-
Run the app using the following command:
flutter run
To use the Movies API from http://moviesapi.ir/, you need to obtain an API key. Once you have the key, open the lib/config/api_config.dart file and replace the placeholder value with your API key:
class ApiConfig {
static const String apiKey = 'YOUR_API_KEY';
}Contributions to this project are welcome. If you encounter any issues or have suggestions for improvements, please feel free to submit an issue or a pull request.
Before contributing, please read our contribution guidelines.
This project is licensed under the MIT License.
- Thanks to the team at http://moviesapi.ir/ for providing the Movies API.
- Special thanks to the Flutter community for their support and the amazing libraries and tools they have developed.
- Thanks for the inspiration https://dribbble.com/shots/20285249-Movie-App-Exploration/attachments/15347450?mode=media
- Thanks to Unsplash for the images and icons.
For any inquiries or questions, please contact @Mail.
If you find this project useful or interesting, we would greatly appreciate your support by giving it a star ⭐️ on GitHub. Your feedback and contribution are invaluable in helping us improve and enhance the app for everyone's benefit. Thank you for your support!
