Food waste contributes to 6% of global greenhouse gas emissions. FoodSaver helps you track food items, get expiration alerts, and discover recipes to reduce waste and save money.
- 🌍 About
- ✨ Features
- 🖼️ Screenshots
- 🚀 Quick Start
- 🛠️ Technology Stack
- 📱 Features in Detail
- 🔧 Installation
- 🌐 Environment Setup
- 📖 Usage Guide
- 🤝 Contributing
- 🔮 Future Roadmap
- 📄 License
FoodSaver is a comprehensive web application designed to combat food waste by providing intelligent food tracking, expiration alerts, and recipe suggestions. With the global food waste crisis contributing significantly to environmental damage, this application offers a practical solution for households and restaurants.
- Reduce Food Waste: Track and manage food items before they expire
- Save Money: Prevent unnecessary grocery spending
- Protect Environment: Reduce greenhouse gas emissions from food waste
- Help Communities: Minimize waste that could feed those in need
- Smart Food Tracking: Add, edit, and monitor food items with expiration dates
- Expiration Alerts: Get timely notifications before food expires
- Recipe Suggestions: Discover recipes using available ingredients
- Multi-language Support: Available in English and Hindi
- Interactive Chatbot: AI-powered assistant for food management tips
- Responsive Design: Works seamlessly on desktop, tablet, and mobile
- Intuitive Interface: Easy-to-use dashboard with card-based layout
- Custom Scrollbar: Enhanced visual experience
- Real-time Updates: Instant synchronization across the application
- User Authentication: Secure login/signup with OTP verification
- Data Persistence: Reliable storage and retrieval of food data
- API Integration: Seamless backend communication
| Feature | Screenshot |
|---|---|
| Home Page |  |
| Add Food Item |  |
| Recipe Suggestions |  |
| Multi-language Support |  |
| Smart Chatbot |  |
# Clone the repository
git clone https://github.com/mohit200008/FoodSaver20008.git
# Navigate to project directory
cd FoodSaver20008
# Install dependencies
npm install --legacy-peer-deps
# Start the development server
npm startThe application will be available at http://localhost:3000
- React.js (v16.10.2) - User interface framework
- React Router DOM - Client-side routing
- Bootstrap (v5.1.3) - CSS framework
- Styled Components - Component styling
- Axios - HTTP client for API calls
- React Simple Chatbot - Interactive chatbot component
- Victory.js - Data visualization charts
- React Bootstrap - Bootstrap components for React
- OTP Input React - OTP verification components
- React Scripts - Build and development tools
- ESLint - Code quality and consistency
- Webpack - Module bundler
- Add Food Items: Input food name, quantity, and expiration date
- Edit Items: Modify existing food entries
- Delete Items: Remove expired or consumed items
- Expiration Tracking: Automatic calculation of days until expiration
- Visual Indicators: Color-coded cards for different expiration states
- Ingredient Matching: Find recipes based on available ingredients
- Recipe Database: Access to extensive recipe collection
- Step-by-step Instructions: Detailed cooking guidance
- Nutritional Information: Health and dietary information
- Food Management Tips: Get advice on food storage and preservation
- Recipe Recommendations: Ask for cooking suggestions
- Expiration Reminders: Chat-based notification system
- Interactive Learning: Educational content about food waste
- English Interface: Primary language support
- Hindi Interface: Regional language accessibility
- Seamless Switching: Easy language toggle
- Localized Content: Culturally relevant information
git clone https://github.com/mohit200008/FoodSaver20008.git
cd FoodSaver20008npm install --legacy-peer-depsNote: We use
--legacy-peer-depsto resolve dependency conflicts betweenreact-simple-chatbotandstyled-components.
npm startOpen your browser and navigate to http://localhost:3000
To use recipe features, you'll need to set up API credentials:
- Get API Keys: Visit Edamam to obtain your API credentials
- Create Environment File: Create a
.envfile in the root directory - Add Credentials:
REACT_APP_APP_ID=your_edamam_app_id REACT_APP_APP_KEY=your_edamam_app_key
| Variable | Description | Required |
|---|---|---|
REACT_APP_APP_ID |
Edamam API Application ID | Yes (for recipes) |
REACT_APP_APP_KEY |
Edamam API Application Key | Yes (for recipes) |
- Launch Application: Open
http://localhost:3000in your browser - Create Account: Sign up for a new account or log in
- Add Food Items: Click "Add Food" to input your food inventory
- Set Expiration Dates: Specify when each item expires
- Monitor Dashboard: View all items and their expiration status
- Add New Item: Use the "Add Food" button to input new items
- Edit Existing: Click on any food card to modify details
- Delete Items: Remove items that have been consumed or expired
- Track Expiration: Monitor the countdown to expiration dates
- Browse Recipes: Explore recipe suggestions based on available ingredients
- Filter Options: Use filters to find specific types of recipes
- Save Favorites: Bookmark recipes for future reference
- Share Recipes: Share cooking inspiration with others
- Ask Questions: Interact with the chatbot for food management tips
- Get Recommendations: Receive personalized advice
- Learn More: Access educational content about food waste
We welcome contributions from the community! Here's how you can help:
-
Fork the Repository
# Click the Fork button on GitHub, then clone your fork git clone https://github.com/YOUR_USERNAME/FoodSaver20008.git cd FoodSaver20008
-
Set Up Upstream
git remote add upstream https://github.com/mohit200008/FoodSaver20008.git
-
Create Feature Branch
git checkout -b feature/your-feature-name
-
Make Changes & Commit
# Make your changes git add . git commit -m "feat: add your feature description"
-
Push & Create Pull Request
git push origin feature/your-feature-name # Create PR on GitHub
- Code Style: Follow existing code formatting and ESLint rules
- Testing: Test your changes thoroughly before submitting
- Documentation: Update documentation for new features
- Screenshots: Include screenshots for UI changes
- Commit Messages: Use clear, descriptive commit messages
- Bug Reports: Include steps to reproduce and expected behavior
- Feature Requests: Describe the feature and its benefits
- Screenshots: Attach relevant screenshots when applicable
- Receipt Scanner: Upload grocery receipts for automatic food addition
- Mobile App: React Native application for better mobile experience
- Cross-platform: Desktop application for offline use
- Advanced Alerts: Push notifications and email reminders
- Enhanced Chatbot: AI-powered food management assistant
- Performance Optimization: Faster loading and better responsiveness
- Database Integration: Persistent data storage
- API Enhancements: More recipe sources and food databases
- Security Upgrades: Enhanced authentication and data protection
- User Base: Reach 10,000+ active users
- Waste Reduction: Help users reduce food waste by 50%
- Community: Build a supportive community of food-conscious users
- Education: Provide educational content about sustainable living
This project is licensed under the MIT License - see the LICENSE file for details.
- Edamam API: Recipe and nutrition data
- React Community: Excellent documentation and support
- Open Source Contributors: Everyone who has contributed to this project
- Environmental Organizations: Inspiration for creating positive impact
Made with ❤️ for a sustainable future