hotdeals-app is an online marketplace app developed with Flutter.



  • Social sign in with Facebook and Google (using Firebase Authentication)
  • State management using Provider
  • Service Locator using get_it
  • In-app messaging
  • Notifications (using Firebase Cloud Messaging)
  • Localization (l10n)
  • Light and Dark theme

Getting Started

To get a local copy up and running follow these simple steps.



  1. Clone the repo using: git clone
  2. Register the app on Firebase.
  3. Download the configuration file from the Firebase Console (google-services.json) and copy it into the android/app directory.
  4. Open android/app/src/main/res/values/strings.xml file and change facebook_app_id and fb_login_protocol_scheme values with yours.
  5. The environment configuration will be read from config/dev_config.dart by default unless you specify the environment using --dart-define=ENV=prod in the run args. Depending your environment, you may need to change apiBaseUrl inside the dev_config.dart.
  6. To get the packages needed for the app, run:
flutter pub get


If you have a connected device or emulator running, you can run the app with:

flutter run


See the open issues for a list of proposed features (and known issues).

Code Contributors

This project exists thanks to all the people who contribute.


? Contributing

Contributions, issues and feature requests are welcome.
Feel free to check issues page if you want to contribute.


? Halil ─░brahim Durmu┼č