Skip to content

Latest commit

 

History

History
155 lines (117 loc) · 4.31 KB

README.md

File metadata and controls

155 lines (117 loc) · 4.31 KB

Finder - Campus Marketplace App 🎓

Flutter

Finder is a campus-specific marketplace application that revolutionizes how college communities buy and sell items. Inspired by Tinder's intuitive interface, Finder creates a secure, anonymous platform for students and staff to trade items within their campus community.

🎯 Problem Statement

College students often discard useful items during moves or upgrades, while others might need these same items. There's no efficient, campus-specific platform to connect these two groups. Finder bridges this gap while promoting sustainability.

🌟 Key Features

  • Campus-Restricted Access: Secure .edu email verification
  • Tinder-Style Interface: Intuitive swipe mechanics for browsing items
  • Anonymous Listings: Privacy-first approach to buying and selling
  • Secure Messaging: Built-in chat system for buyer-seller communication
  • Smart Categories: Easy organization of items by type and condition
  • Order Tracking: Real-time updates on purchase status

🔄 System Architecture

Authentication Flow

flowchart TD
    A[Start] --> B[Splash Screen]
    B --> C[Email Verification]
    C --> D{Valid .edu?}
    D -->|Yes| E[Create/Login Account]
    D -->|No| F[Access Denied]
    E --> G[Role Selection]
    G --> H[Buyer Mode]
    G --> I[Seller Mode]
Loading

Seller Flow

flowchart TD
    A[Seller Mode] --> B[Create Listing]
    B --> C[Add Photos]
    C --> D[Item Details]
    D --> E[Set Price]
    E --> F[Preview]
    F --> G[Post Listing]
    G --> H[Active Listings]
    H --> I[Message Center]
    H --> J[Order Management]
Loading

Buyer Flow

flowchart TD
    A[Buyer Mode] --> B[Browse Items]
    B --> C[View Details]
    C --> D{Decision}
    D -->|Pass| B
    D -->|Like| E[Shopping Cart]
    D -->|Chat| F[Message Seller]
    E --> G[Payment]
    G --> H[Order Confirmation]
    H --> I[Track Order]
Loading

Messaging System

flowchart TD
    A[Message Center] --> B[Inbox]
    B --> C[Chat Threads]
    C --> D[Price Negotiation]
    C --> E[Meeting Arrangement]
    C --> F[Item Questions]
Loading

💻 Technology Stack

  • Frontend: Flutter/FlutterFlow
  • Backend: Firebase
  • Authentication: Firebase Auth
  • Database: Cloud Firestore
  • Storage: Firebase Storage
  • Messaging: Firebase Cloud Messaging

🚀 Getting Started

Prerequisites

  • Flutter SDK
  • FlutterFlow account
  • Firebase project
  • Android Studio / VS Code

Installation

  1. Clone the repository
git clone https://github.com/yourusername/finder-app.git
  1. Navigate to project directory
cd finder-app
  1. Install dependencies
flutter pub get
  1. Run the app
flutter run

👥 Team

Core Developers

  • Md Khairul Islam

    • Institution: Hobart and William Smith Colleges, Geneva, NY
    • Major: Robotics and Computer Science
    • Contact: [email protected] | (315) 878-9695

  • Md Wasiful Karim

    • Institution: Ohio Wesleyan University, Ohio, USA
    • Major: Astrophysics and Computer Science
    • Contact: [email protected] | (740) 803-6371

📱 App Screenshots

7

🤝 Contributing

We welcome contributions to Finder! for details on our code of conduct and the process for submitting pull requests.

🙏 Acknowledgments

  • HackPrinceton 2024 - Where this project was initially conceived and developed during the 36-hour hackathon at Princeton University

  • Hobart and William Smith Robotics Club

    • Liam Davidson – For invaluable feedback, technical expertise, and driving support during the Hackathon
    • Evan Nolan – A great contributor for brainstorming.
    • Souvick Rodrigues – A wonderful singer.

  • FlutterFlow team - For providing an excellent development platform that made our rapid prototyping possible

  • Our College Communities - For inspiration and continued support in making campus sustainability a priority

  • All contributors - Who have helped shape this project through feedback and testing

📞 Contact

For any queries regarding the application, please contact either of the core developers listed above.

Made with ❤️ for College Communities