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

📦 Download APK

You can try out the latest version of the app by downloading the APK below:

🏗️ Progress Tracker

✅ Done

• Multi-flavored environment (dev, prod, staging)
• Light and Dark theme (Login and Signup screens)
• Localization for English and Bangla (Login and Signup screens)
• App signing
• Realtime bid updates using Supabase realtime database
• User Registration
• Role-based Access Control
• Login and signup Functionality
• Re-usable UIs and components
• Client add request, view RFQs and select bid screens
• Vendor place bid, track bid screens
• Client Dashboard

📝 To-Do

• Payment Integration
• Ratings and Reviews
• Google Sign-In
• Bug Fixes
• Vendor dashboard
• Order confirmation screen

⚠️ 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.

(back to top)

📱 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.

(back to top)

🏗 Schema Diagram

🧩 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

(back to top)

⚒️ Technology Stack

This section lists the major frameworks/tools used to bootstrap this project.

• 
• 
• 

(back to top)

🚀 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
• Android Studio (for Android development)
• Git: Download Git

Verify Flutter installation:

flutter doctor

Installation

1. Clone the repository:

   git clone https://github.com/Learnathon-By-Geeky-Solutions/flutterfly.git

2. Navigate to the project directory:

   cd flutterfly

3. Install dependencies: Run the following command to fetch all dependencies:

   flutter pub get

4. Run the app: Use the following commands to run the app for specific flavors:

   • Development:

     flutter run --flavor dev 

   • Staging:

     flutter run --flavor staging 

   • Production:

     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"
     }
  }
  

(back to top)

⚖️ License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

🌟 Top contributors

(back to top)

🦋 Team Information: Flutterfly

Name	Role	GitHub Username
Mayeesha Musarrat	Team Leader	MayeeshaMusarrat
Maria Sultana	Member	MariaSultana20
Raisa Rahman	Member	raisarahman777
Main Oddin Chisty	Mentor	chisty2996

(back to top)