Rescuing Food, Feeding Communities, Preserving Our Planet.
An intelligent, decentralized platform connecting surplus food sources with individuals and organizations in need, powered by AI prediction models and Web3 blockchain rewards.
Visit the fully verified and functional application at: feedforward-one.vercel.app
Feed-Forward is a next-generation ecosystem built to eradicate food waste and combat hunger. By utilizing real-time geographic routing, artificial intelligence, and a gamified blockchain token economy, we match verified food donors (restaurants, events, farmers) with hungry individuals and NGOs seamlessly.
Every action makes an impact—and every impact is rewarded.
- Food Map & Discovery: Interactive visual map utilizing mapping APIs to instantly locate available surplus food in real-time.
- Donate & Claim Flow: Donors can list food (FoodFlags), and recipients or NGOs can claim and navigate to the pickup point.
- Annapoorna Chatbot: A dedicated AI assistant to help users navigate the platform, understand food safety, and get answers.
- AI Inventory Parsing: Upload food inventory lists and let AI automatically identify items nearing expiry to flag for donation.
- AI Order Verification: Automated visual/textual verification of food deliveries for quality assurance.
- Wallet Connection: Seamlessly link your cryptocurrency wallet via RainbowKit & Wagmi.
- FeedCoin Rewards (FFC): Earn tokenized rewards for donating food, volunteering, or claiming food on time.
- Eco-Marketplace: A decentralized storefront where users can spend their earned FeedCoins on eco-friendly products and sponsor perks.
- Sanjeevani (Disaster Relief): A dedicated disaster response module that reroutes surplus food to climate crisis zones and refugee camps.
- Farmer Distress Donations: Special provisions allowing farmers to donate surplus crops during market crashes to minimize agrarian waste.
- Community Impact Dashboard: Track CO₂ saved, meals donated, and water preserved in real-time.
- Multi-Language Support (i18n): Instantly toggle the entire interface between English (EN) and Hindi (HI) to bridge the gap between rural farmers and urban donators.
- Mobile Responsive: Impeccable UI built with Tailwind CSS & Shadcn, optimized for every device format.
Feed-Forward utilizes a modern, modular architecture:
- Frontend Framework: React 18 / Vite / TypeScript
- Styling: Tailwind CSS + Shadcn UI components + Framer Motion
- Authentication & Database: Supabase (PostgreSQL, Row Level Security, Trigger-based Profile Synchronization)
- Web3 Integration: RainbowKit, Wagmi, viem, Ethers.js
- Routing: React Router DOM v6
- Internationalization:
i18next&react-i18next - Deployment: Vercel (SPA routing configured)
The codebase follows a strictly organized domain-driven architecture:
/src/pages/auth/- Sign In, Sign Up, Profile, Wallet configuration/src/pages/core/- Homepage, Landing content, 404/src/pages/food/- Maps, Donation forms, AI Inventory/src/pages/marketplace/- Eco-Marketplace, Checkout, Seller Dashboards/src/pages/impact/- Sanjeevani, Volunteer flows, CSR connections/src/pages/support/- AI Chatbots and Help Centers
For detailed guides, specifications, and walkthroughs, check out the docs directory:
- Setup Guide: Steps to get the project configured locally.
- Quick Start: Fast path to running the development environment.
- Running the App: Command guide and environment prerequisites.
- Supabase Setup Guide: Database structure, RLS policies, and triggers.
- Deployment Guide: Overview of general deployment pipelines.
- Deploying to Vercel: Direct deployment instructions for Vercel.
- Auth Test Guide: Validating sign-up, sign-in, and session behaviors.
- Test Checklist: Step-by-step checklist to verify all features.
- Revenue Model Guide: Explanation of platform fee models.
- Revenue Upgrade Plan: Roadmap for upgrading subscription plans.
- Revenue Quickstart: Developer quickstart for revenue-related services.
- Product Requirements Document (PRD): Detailed feature list and business goals.
- Implementation Summary: Architectural and code status breakdown.
- Node.js (v18+)
- Web3 Wallet (e.g., MetaMask to test blockchain connections)
- A Supabase Project (for Auth & DB)
-
Clone the repository
git clone https://github.com/ImperialCoder01/FeedForward.git cd FeedForward -
Install dependencies
npm install
-
Environment Setup Create a
.envfile in the root and add your Supabase credentials:VITE_SUPABASE_URL=your_supabase_project_url VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
-
Start the Development Server
npm run dev
The application will be running at
http://localhost:8080!
To run the application properly, the Supabase backend relies on multiple automated triggers to keep user accounts synced with profiles. The included SQL file (supabase/fix_signup_complete.sql) contains the exact definitions for our robust SECURITY DEFINER triggers that bypass RLS to ensure smooth onboarding.
Project Feed-Forward directly aligns with UN SDGs:
- SDG 2: Zero Hunger
- SDG 11: Sustainable Cities and Communities
- SDG 12: Responsible Consumption and Production
- SDG 13: Climate Action
Contributions are absolutely welcome! We are always looking for open-source contributors to help us expand our AI models, fix bugs, or add new local languages to the i18n roster.
Please read our contributing guidelines before submitting a Pull Request.