feedaily

Connecting people to save food, fight hunger, and reduce waste.

Table of Contents

• About
• Demo
• Features
• Tech Stack
• Getting Started
  • Prerequisites
  • Installation
  • Running Locally
• Usage
• Contributing
• Issue Labels
• License
• Contact
• Contributors

About

Feedaily is a platform aimed at reducing food waste by connecting those who have excess food with those in need. It empowers communities to share, donate, or redistribute surplus food, helping to fight hunger and promote sustainability.

Flow Diagram

Features

• User Authentication & Profiles
• Create listings of Surplus Food
• Browse nearby Food Offers
• Claim / Reserve food
• Image classification to Validate Food
• Notifications / Status tracking
• Admin Moderation
• Email Service Integration
• WhatsApp Bot Integration
• Payment Gateway Integration (Stripe)
• Live location tracking

Tech Stack

┌─────────────────────────────────────────────────────────────────┐
│                        FULL STACK ARCHITECTURE                  │
├─────────────────┬─────────────────┬─────────────────────────────┤
│    FRONTEND     │     BACKEND     │        AI/ML COMPONENTS     │
├─────────────────┼─────────────────┼─────────────────────────────┤
│ • React         │ • Express.js    │ • CNN Image Classification  │
│ • Vite          │ • Node.js       │ • TensorFlow Models         │
│ • Tailwind CSS  │ • SQLite        │ • File Processing           │
│ • GSAP Animations│ • REST APIs    │ • Image Recognition         │
│ • React Router  │ • File Uploads  │                             │
│ • Google Charts │ • Authentication│        INTEGRATIONS         │
│ • jsPDF Export  │ • bcrypt        ├─────────────────────────────┤
│ • React Webcam  │ • Sessions      │ • WhatsApp API              │
│                 │ • Nodemailer    │ • Twilio SMS                │
│                 │                 │ • Stripe Payments           │
└─────────────────┴─────────────────┴─────────────────────────────┘

Getting Started

Prerequisites

Before you get started, ensure you have the following installed:

• Node.js (v16 or newer)
• npm or yarn
• SQLite (optional if using file-based database)

Installation

1. Clone the repository:

git clone https://github.com/peteroin/feedaily.git
cd feedaily

2. Install dependencies:

# frontend
cd frontend
npm install

# backend
cd ../backend
npm install

Running Locally

3. Run frontend:

cd frontend
npm run dev
# default: http://localhost:5173

4. Run backend:

cd backend
node server.js
# API runs on: http://localhost:5000

The frontend should now communicate with the backend API.

Usage

1. Sign up / log in
2. Create a new food listing (name, description, image, quantity, etc.)
3. Browse available food listings nearby
4. Claim or reserve a listing
5. Track status, notifications, or updates

Possible Extensions

• Search / filtering
• Ratings & feedback
• Map integration for location-based matching

Contributing

We welcome contributions! 🙌 Whether it’s fixing bugs, adding features, improving docs, or writing tests all help is appreciated.

Steps to contribute:

1. Fork the repo
2. Create a branch

git checkout -b feature/my-feature

3. Make your changes
4. Commit & push
5. Open a Pull Request

Note: We follow Conventional Commits for all commit messages.
Check CONTRIBUTING.md for details.

Issue Labels

We use labels to organize issues:

Label	Meaning
good first issue	Beginner-friendly issues
help wanted	Issues where extra help is needed
bug	Something isn’t working
enhancement	New feature requests
documentation	Documentation improvements
question	Questions or clarifications

Contact

Maintainers
Peter • Victor

Contributors

Open an issue or a PR if you have ideas or want to help.

Connecting people to save food, fight hunger, and reduce waste.

💚 Thank you for checking out feedaily - together we can make an impact!