hotdeals-app

hotdeals-app is an online marketplace app developed with Flutter.
The app's Backend can be found here.

Table of Contents

• Screenshots
• Features
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Roadmap
• Code Contributors
• Contributing
• Author
• License
• Acknowledgements

Screenshots

Features

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

Getting Started

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

Prerequisites

• You need to have Flutter installed on your pc.
  • Install Flutter
• You need to have hotdeals-backend ready in your system.

Installation

1. Clone the repo using: git clone https://github.com/halildurmus/hotdeals-app.git
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

Usage

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

flutter run

Roadmap

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.

Author

👤 Halil İbrahim Durmuş

• Github: @halildurmus

📝 License

This project is MIT licensed.

Acknowledgements

• Country Icons made by Freepik from www.flaticon.com
• Img Shields
• Preview mockups were created with AppMockUp