https://github.com/learnathon-by-geeky-solutions/flutterfly
Repository for QuickDeal: A marketplace platform where users request custom product quotes, vendors bid, and finalized projects are confirmed with digital agreements and payments.
https://github.com/learnathon-by-geeky-solutions/flutterfly
bidding-app clean-architecture clean-architecture-android ecommerce firebase flutter mobile-app repository-pattern riverpod
Last synced: about 1 year ago
JSON representation
Repository for QuickDeal: A marketplace platform where users request custom product quotes, vendors bid, and finalized projects are confirmed with digital agreements and payments.
- Host: GitHub
- URL: https://github.com/learnathon-by-geeky-solutions/flutterfly
- Owner: Learnathon-By-Geeky-Solutions
- License: mit
- Created: 2024-12-25T09:58:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-27T14:13:03.000Z (over 1 year ago)
- Last Synced: 2025-03-27T15:26:20.609Z (over 1 year ago)
- Topics: bidding-app, clean-architecture, clean-architecture-android, ecommerce, firebase, flutter, mobile-app, repository-pattern, riverpod
- Language: Dart
- Homepage:
- Size: 3.46 MB
- Stars: 1
- Watchers: 0
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![Unlicense License][license-shield]][license-url]
[](https://sonarcloud.io/dashboard?id=Learnathon-By-Geeky-Solutions_flutterfly)
[](https://sonarcloud.io/component_measures/domain/Vulnerability?id=Learnathon-By-Geeky-Solutions_flutterfly)
[](https://sonarcloud.io/component_measures/domain/Bugs?id=LLearnathon-By-Geeky-Solutions_flutterfly)
[](https://sonarcloud.io/component_measures/domain/Security?id=LLearnathon-By-Geeky-Solutions_flutterfly)
A marketplace platform where users request custom product quotes, vendors bid, and finalized projects are confirmed with digital agreements and payments.
View Demo
·
Report Bug
·
Request Feature
📖 Table of Contents
- ➡️ Visit Our Wiki
- ⚠️ Problem Statement
- [📱 Features](#-features)
- [🧩 Project Structure: Feature-First Clean Architecture with Repository Pattern](#clean)
- ➡️ Visit Our Wiki
- [🚀 Getting Started](#-getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Setting Up Flavors](#setting-up-flavors)
- ⚖️ License
- [🌟 Top Contributors](#-top-contributors)
- 🦋 Team Information: Flutterfly
For comprehensive documentation, guides, and resources related to the Flutterfly project, please explore our [Wiki](https://github.com/Learnathon-By-Geeky-Solutions/flutterfly/wiki). It provides in-depth insights to help you understand and contribute effectively.
## ⚠️ Problem Statement
Many businesses and individuals struggle to find the right vendors for customized products or services, leading to inefficiencies, high costs, and delays. Vendors, on the other hand, lack a centralized platform to discover potential clients and bid on projects effectively.
This app bridges the gap by providing a streamlined bidding and quotation system.
## 📱 Features
### 🛒 Vendor Registration and Services
- Vendors can register with business details and services offered.
- They can link portfolios and set business hours.
- Certificates and social media links can be added for credibility.
### 💼 Order Process and Payment
- Clients can view ongoing bids and select preferred vendors.
- Payment can be completed through a gateway or cash-on-delivery.
- Invoices are generated post order completion.
### 📝 User Profile Setup
- Users can set up profiles with mandatory and optional information.
- Business accounts require additional details like business type and registration number.
### 💬 Communication and Reviews
- Clients can rate and review vendors post order completion.
- Vendors can update bids and communicate with clients for better deals.
### 📅 Order Tracking and Completion
- Clients can track active orders and view payment status.
- Orders are confirmed post payment completion and vendors can generate digital agreements.
## 🧩 Project Structure: Feature-First Clean Architecture with Repository Pattern
```
bidding_ecommerce/
├── src/
│ ├── features/
│ │ ├── auth/
│ │ │ ├── domain/
│ │ │ │ ├── entities/
│ │ │ │ │ └── user.dart
│ │ │ │ ├── repositories/
│ │ │ │ │ └── auth_repository.dart
│ │ │ │ └── use_cases/
│ │ │ │ ├── login_use_case.dart
│ │ │ │ └── register_use_case.dart
│ │ │ ├── data/
│ │ │ │ ├── repositories/
│ │ │ │ │ └── auth_repository_impl.dart
│ │ │ │ └── data_sources/
│ │ │ │ ├── auth_local_data_source.dart
│ │ │ │ └── auth_remote_data_source.dart
│ │ │ └── presentation/
│ │ │ ├── pages/
│ │ │ │ ├── login_page.dart
│ │ │ │ └── register_page.dart
│ │ │ └── controllers/
│ │ │ └── auth_controller.dart
│ │ │
│ │ ├── product/
│ │ │ ├── domain/
| | | ├── ...
│ ├── core/
│ │ ├── error/
│ │ │ ├── exceptions.dart
│ │ │ └── failures.dart
│ │ ├── network/
│ │ │ ├── api_client.dart
│ │ │ └── network_info.dart
│ │ ├── utils/
│ │ │ ├── constants.dart
│ │ │ └── validators.dart
│ │ └── config/
│ │ └── app_config.dart
│ │
│ ├── shared/
│ │ ├── domain/
│ │ │ └── entities/
│ │ │ └── base_entity.dart
│ │ ├── data/
│ │ │ └── models/
│ │ │ └── base_model.dart
│ │ └── presentation/
│ │ ├── widgets/
│ │ │ ├── loading_widget.dart
│ │ │ └── error_widget.dart
│ │ └── themes/
│ │ └── app_theme.dart
│ │
│ └── main.dart
│
├── test/
│ ├── features/
│ │ ├── auth/
│ │ ├── product/
│ │ ├── bidding/
│ │ ├── payment/
│ │ └── order/
| | └── review/
│ └── core/
│
├── pubspec.yaml
└── README.md
```
## ⚒️ Technology Stack
This section lists the major frameworks/tools used to bootstrap this project.
* [![Figma][Figma]][Figma-url]
* [![Flutter][Flutter]][Flutter-url]
* [![Dart][Dart]][Dart-url]
## 🚀 Getting Started
To set up the Flutterfly project locally and run it with different flavors (prod, dev, staging), follow the steps below.
### Prerequisites
Make sure you have the following tools installed on your system:
- **Flutter SDK**: [Install Flutter](https://docs.flutter.dev/get-started/install)
- **Android Studio** (for Android development)
- **Git**: [Download Git](https://git-scm.com/)
Verify Flutter installation:
```sh
flutter doctor
```
### Installation
1. **Clone the repository**:
```sh
git clone https://github.com/Learnathon-By-Geeky-Solutions/flutterfly.git
```
2. **Navigate to the project directory**:
```sh
cd flutterfly
```
3. **Install dependencies**:
Run the following command to fetch all dependencies:
```sh
flutter pub get
```
4. **Run the app**:
Use the following commands to run the app for specific flavors:
- **Development**:
```sh
flutter run --flavor dev
```
- **Staging**:
```sh
flutter run --flavor staging
```
- **Production**:
```sh
flutter run --flavor prod
```
### Setting Up Flavors
The Flutterfly project is configured with multiple flavors to manage environments effectively. Each flavor has its corresponding configuration in the `android` folder.
- Flavors are defined in the `android/app/build.gradle` file:
```
flavorDimensions "environment"
productFlavors {
dev {
dimension "environment"
applicationIdSuffix ".dev"
versionNameSuffix "-dev"
}
staging {
dimension "env"
applicationIdSuffix ".staging"
versionNameSuffix "-staging"
}
prod {
dimension "environment"
}
}
```
## ⚖️ License
Distributed under the MIT License. See `LICENSE` for more information.
## 🌟 Top contributors
## 🦋 Team Information: Flutterfly
| Name | Role | GitHub Username |
|-------------------| ----------- |--------------------------------------|
| Mayeesha Musarrat | Team Leader | [MayeeshaMusarrat](https://github.com/MayeeshaMusarrat) |
| Maria Sultana | Member | [MariaSultana20](https://github.com/MariaSultana20) |
| Raisa Rahman | Member | [raisarahman777](https://github.com/raisarahman777) |
| Main Oddin Chisty | Mentor | [chisty2996](https://github.com/chisty2996) |
[contributors-shield]: https://img.shields.io/github/contributors/Learnathon-By-Geeky-Solutions/flutterfly.svg?style=for-the-badge
[contributors-url]: https://github.com/Learnathon-By-Geeky-Solutions/flutterfly/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/Learnathon-By-Geeky-Solutions/flutterfly.svg?style=for-the-badge
[forks-url]: https://github.com/Learnathon-By-Geeky-Solutions/flutterfly/network/members
[stars-shield]: https://img.shields.io/github/stars/Learnathon-By-Geeky-Solutions/flutterfly.svg?style=for-the-badge
[stars-url]: https://github.com/Learnathon-By-Geeky-Solutions/flutterfly/stargazers
[issues-shield]: https://img.shields.io/github/issues/Learnathon-By-Geeky-Solutions/flutterfly.svg?style=for-the-badge
[issues-url]: https://github.com/Learnathon-By-Geeky-Solutions/flutterfly/issues
[license-shield]: https://img.shields.io/github/license/Learnathon-By-Geeky-Solutions/flutterfly.svg?style=for-the-badge&color=color=#50C878
[license-url]: https://github.com/Learnathon-By-Geeky-Solutions/flutterfly/blob/master/LICENSE
[FigJam]: https://img.shields.io/badge/FigJam-F24E1E?style=for-the-badge&logo=figma&logoColor=white
[FigJam-url]: https://www.figma.com/figjam/
[sonarqube-shield]:https://img.shields.io/static/v1?label=Quality%20Gate&message=Passed&color=brightgreen&style=for-the-badge
[sonarqube-url]: https://sonarcloud.io/dashboard?id=Learnathon-By-Geeky-Solutions_flutterfly
[Figma]: https://img.shields.io/badge/Figma-F24E1E?style=for-the-badge&logo=figma&logoColor=white
[Figma-url]: https://www.figma.com/
[Flutter]: https://img.shields.io/badge/Flutter-02569B?style=for-the-badge&logo=flutter&logoColor=white
[Flutter-url]: https://flutter.dev/
[Dart]: https://img.shields.io/badge/Dart-0175C2?style=for-the-badge&logo=dart&logoColor=white
[Dart-url]: https://dart.dev/