muhammad-hassan-shakeel / molix

molix

Molix is a Flutter app that shows the personalised and popular movies. You can use this app accross both mobile platforms i.e iOS and android. App supports both light and dark theme, will add more attractive themes in the future. We also plan to add web and desktop support in the future.

Getting Started

Prerequisites to run the code

• Flutter
• Android Studio or Visual Studio Code
• Git
• Xcode (MacOS only)

Prerequisites to understand the codebase

• Flutter
• Dart
• Provider
• BLoC
• AutoRoute

Project Setup

• Clone the repository
• Open the project in Android Studio or Visual Studio Code
• Run flutter pub get to install dependencies
• Run flutter run --flavor dev -t lib/main_dev.dart to run the app in development mode
• Run flutter run --flavor prod -t lib/main_prod.dart to run the app in production mode
• Run flutter build apk --flavor dev -t lib/main_dev.dart to build the app in development mode
• Run flutter build apk --flavor prod -t lib/main_prod.dart to build the app in production mode

Project Structure

• All the moddule are contained in the features directory inside the lib directory
• Each module has its own bloc, views and repository directory
• The bloc directory contains all the blocs related to that module
• The views directory contains all the views related to that module
• The repository directory contains all the repositories and models related to that module

Code Contains

• Flavors
• Unit tests
• Widget tests
• BLoC pattern
• Theme management

Screenshots

Login Screen	Home Screen (dark)	Home Screen (light)	Search	Downloads	Profile

Points to note

App is using Hydrated Bloc to store movies data in local storage. Hydrated bloc saves data in toJson method of MoviesBLoc. It reads data from the local storage in fromJson method of the MoviesBloc