Skip to content

Yo-omega/web-hackathon

Repository files navigation

1337 Marketplace

📌 Overview

A web-based platform designed for 1337 students to buy, sell, exchange products and services, and facilitate peer-to-peer deliveries within the campus. This project combines elements from Avito (buy & sell), Glovo (delivery services), and freelance platforms to create a tailored experience for 1337 students.

🚀 Features

  • Buy & Sell Products: List and browse items (tech gadgets, books, accessories, etc.).
  • Offer & Find Services: Freelance-style service marketplace (coding help, tutoring, design, etc.).
  • Delivery & Errands: Peer-to-peer delivery requests handled via Discord.
  • User Roles: Sellers, buyers, service providers, and delivery helpers.

🛠️ Tech Stack

  • Frontend: HTML, CSS, JavaScript
  • Backend: Node.js
  • Database: JSON-based storage (or database integration if future)
  • Version Control: Git & GitHub
  • Communication: Use 42 intra-profile links.

📂 Project Structure

project/
├── node_modules/           # Dependencies (if using npm)
├── public/                 # Public assets (SVGs, images, etc.)
│   ├── vite.svg            # Vite logo (if applicable)
│   ├── javascript.svg      # JavaScript logo
├── counter.js              # JavaScript logic for counters (if applicable)
├── index.html              # Main HTML file
├── index.js                # Main JavaScript file for Back-end
├── listings.json           # Mock data for product listings
├── main.js                 # Core application logic and main for front-end
├── package.json            # Project dependencies and metadata
├── package-lock.json       # Dependency lock file
├── style.css               # Stylesheet

🔧 Installation & Setup

  1. Clone the repository:
    git clone https://github.com/Yo-omega/web-hackathon.git
  2. Navigate to the project directory:
    cd web-hackathon/project
  3. Install dependencies (better using Node.js):
    npm i
  4. Run the project locally:
    npm start
    or simply open index.html in a browser.

📜 Usage Guide

  1. Listing Items: Navigate the product sections or click "Add Item," and fill in the details.
  2. Finding Services: Use the search bar and filters to find the right product/servicen.
  3. Requesting a Delivery: Post a request, wait for an available student to contact you based on your intra's information.

🤝 Contributing

We welcome contributions! To contribute:

  1. Fork the repository.
  2. Create a feature branch: git checkout -b feature-name
  3. Commit your changes: git commit -m "Add feature X"
  4. Push to the branch: git push origin feature-name
  5. Open a pull request!

📄 License

This project is licensed under the MIT License.

📧 Contact

For any questions or suggestions, feel free to reach out via Discord or open an issue on GitHub.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •