https://github.com/ahmad131554/feed2need
Online grocery platform connecting rural sellers with urban customers using React + Supabase. Features Stripe payments, seller/admin dashboards, and real-time order tracking.
https://github.com/ahmad131554/feed2need
ecommerce frontend fyp grocery react rural-ecommerce stripe supabase tailwindcss
Last synced: 3 months ago
JSON representation
Online grocery platform connecting rural sellers with urban customers using React + Supabase. Features Stripe payments, seller/admin dashboards, and real-time order tracking.
- Host: GitHub
- URL: https://github.com/ahmad131554/feed2need
- Owner: Ahmad131554
- Created: 2025-06-19T05:27:12.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-07-18T09:33:48.000Z (3 months ago)
- Last Synced: 2025-07-18T13:40:16.608Z (3 months ago)
- Topics: ecommerce, frontend, fyp, grocery, react, rural-ecommerce, stripe, supabase, tailwindcss
- Language: JavaScript
- Homepage: https://feed2need.vercel.app
- Size: 7.14 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🛒 Feed2Need - Bridging Rural Sellers and Urban Customers



**Feed2Need** is an online grocery platform connecting rural sellers with urban customers, ensuring access to locally sourced, high-quality products. Built with modern web technologies for seamless user experiences.
👉 [Live Demo](https://feed2need.vercel.app/)
---
## ✨ Key Features
### **Customer Portal**
- 🛍️ Browse shops/products with filters
- 🛒 Cart & checkout with **Stripe payments**
- 📦 Order history with status tracking
- ❤️ Wishlist & account management### **Seller Portal**
- 🏪 Shop creation & profile verification
- 📊 Product CRUD operations
- 📦 Order management dashboard
- 💼 Seller analytics### **Admin Dashboard**
- 📊 Platform analytics (orders, users)
- ✅ Seller verification
- 🏷️ Category management
- 🔍 Full order oversight---
## 🛠️ Tech Stack
| Category | Technologies/Libraries |
| -------------- | ------------------------------------------------------------------- |
| **Frontend** | React, React Router, TailwindCSS, React Query, React Hook Form, Zod |
| **Backend** | Supabase (Auth, Database, Storage) |
| **Payment** | Stripe (Test mode) |
| **UI/UX** | React Hot Toast, React Icons |
| **Deployment** | Vercel (Frontend), Supabase (Backend) |---
## 🚀 Installation
1. Clone the repo:
```bash
`git clone https://github.com/Ahmad131554/feed2need.git`
```2. Install dependencies:
```bash
`npm install`
```3. Set up environment variables (create `.env` file):
```bash
VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_KEY=your_supabase_key
VITE_STRIPE_PUBLIC_KEY=your_stripe_key
```4. Run locally:
```bash
`npm run dev`
```---
## 🌟 Why Feed2Need?
- **Empowers Rural Sellers**: Direct market access without middlemen
- **Quality Assurance**: Urban customers get fresh, locally sourced products
- **End-to-End Flow**: Complete order lifecycle from cart to delivery tracking
- **Modern Stack**: Scalable architecture with React + Supabase---
## 📄 License
MIT © [Muhammad Ahmad](https://github.com/Ahmad131554)