StreetFood Connect - Group Ordering Platform

🍽️ Project Overview

StreetFood Connect is a web-based platform that solves the raw material sourcing problem for street food vendors in India. By enabling group ordering, vendors can save 15-25% on their raw material costs while suppliers get bulk orders.

🎯 Problem Solved

• Individual vendors pay 20-30% more buying raw materials alone
• No trusted platform for vendors to find reliable suppliers
• Lack of bulk ordering opportunities for better pricing
• Poor supply chain visibility and coordination

🚀 Solution Features

For Vendors:

• ✅ Easy registration and profile management
• ✅ Add items to shopping list with quantities
• ✅ Create group orders to attract other vendors
• ✅ Join existing group orders to save money
• ✅ Real-time order status tracking
• ✅ Mobile-friendly interface

For Suppliers:

• ✅ Supplier registration and catalog management
• ✅ View and manage pending group orders
• ✅ Accept/reject orders with one click
• ✅ Set competitive pricing for bulk orders
• ✅ Order status management

🛠️ Tech Stack

• Frontend: HTML5, CSS3, JavaScript (Vanilla)
• Backend: Node.js, Express.js
• Database: MongoDB
• Styling: Tailwind CSS
• Icons: Font Awesome
• Deployment: Ready for Vercel/Netlify

📱 Key Features

1. Group Ordering System: Vendors can create or join group orders
2. Real-time Updates: Order status updates instantly
3. Mobile Responsive: Works perfectly on all devices
4. User-friendly UI: Clean, intuitive interface
5. Notification System: Real-time feedback for all actions

🚀 Quick Start

Prerequisites

• Node.js (v14 or higher)
• MongoDB (local or cloud)

Installation

1. Clone the repository

   git clone <repository-url>
   cd web-hack10

2. Install dependencies

   npm install

3. Set up environment variables Create a .env file:

   MONGODB_URI=mongodb://localhost:27017/streetfood-vendors
   PORT=3000
   

4. Start the development server

   npm run dev

5. Open your browser Navigate to http://localhost:3000

📊 How It Works

Vendor Flow:

1. Register as a street food vendor
2. Add items you need to your shopping list
3. Create a group order or join an existing one
4. Track order status and save money!

Supplier Flow:

1. Register as a supplier
2. Add items to your catalog with pricing
3. Review pending orders from vendors
4. Accept/reject orders and manage delivery

💡 Demo Scenarios

Scenario 1: Vendor Creates Group Order

1. Register as "Raj's Chaat Corner"
2. Add items: 10kg potatoes, 5kg onions, 2kg tomatoes
3. Create group order
4. Other vendors can join and save money

Scenario 2: Supplier Manages Orders

1. Register as "Fresh Foods Supplier"
2. Add items with competitive pricing
3. View pending group orders
4. Accept orders and manage delivery

🎯 Impact & Benefits

• Cost Savings: Vendors save 15-25% on raw materials
• Better Quality: Verified suppliers and bulk pricing
• Time Efficiency: Streamlined ordering process
• Community Building: Vendors can collaborate
• Business Growth: Suppliers get consistent bulk orders

🔧 API Endpoints

Vendors

• POST /api/vendors - Register new vendor
• GET /api/vendors - Get all vendors

Suppliers

• POST /api/suppliers - Register new supplier
• GET /api/suppliers - Get all suppliers

Group Orders

• POST /api/group-orders - Create new group order
• GET /api/group-orders - Get all group orders
• PUT /api/group-orders/:id - Update order status
• POST /api/group-orders/:id/vendors - Add vendor to order

🚀 Deployment

Vercel Deployment

1. Push code to GitHub
2. Connect repository to Vercel
3. Set environment variables
4. Deploy automatically

Netlify Deployment

1. Build the project
2. Upload to Netlify
3. Configure environment variables
4. Deploy

📱 Mobile Responsive

The platform is fully responsive and works perfectly on:

• 📱 Mobile phones
• 📱 Tablets
• 💻 Desktop computers
• 🖥️ Large screens

🎨 UI/UX Features

• Modern Design: Clean, professional interface
• Intuitive Navigation: Easy to use for all users
• Color-coded Status: Visual order status indicators
• Real-time Feedback: Instant notifications for all actions
• Accessible: Works for users with different technical skills

🔮 Future Enhancements

• Payment integration
• Delivery tracking
• Vendor ratings and reviews
• Advanced analytics
• Push notifications
• Multi-language support

👥 Team Information

Built for Tutedude's Web Development Hackathon 1.0

• Problem: Street food vendors struggle with raw material sourcing
• Solution: Group ordering platform for bulk purchases
• Impact: 15-25% cost savings for vendors
• Technology: Full-stack web application

📞 Support

For any questions or issues, please refer to the hackathon submission guidelines.

---

Built with ❤️ for India's Street Food Vendors