🍳 PantryChef – AI-Powered Food Waste Reduction Platform

Transform your leftovers into delicious meals with AI-powered recipe matching and smart kitchen management.

✨ Live Demo

https://pantry-chef-brown.vercel.app/

🎯 Features

🧠 Smart AI Integration

AI Recipe Matching – Intelligent algorithm finds perfect recipes based on available ingredients
Ingredient Scanner – Camera-based ingredient recognition with quantity estimation
Expiration Tracking – Smart notifications for ingredients nearing expiration

👨‍🍳 Educational Content

Master Methods – Step-by-step cooking technique tutorials
Interactive Tutorials – Hands-on guides with pro tips and video demonstrations
Cooking Fundamentals – Learn essential skills to cook smarter and waste less

🛒 Smart Kitchen Management

AI Shopping Lists – Intelligent grocery lists based on meal plans
Pantry Inventory – Track ingredients with expiration alerts
Meal Planning – Weekly planning to minimize waste from the start

👥 Community Platform

Community Q&A – Get answers from both AI and experienced cooks
Recipe Sharing – Share your creations and discover community favorites
Progress Tracking – Monitor your waste reduction and savings

🔐 User Experience

Secure Authentication – Social login and email/password authentication
Personal Dashboard – Track your environmental impact and savings
Mobile Responsive – Fully responsive design for all devices
WCAG 2.1 Compliant – Accessible to all users

📸 Screenshots

Home Page	Recipe Finder	Shopping List

Master Methods	Community Q&A	User Dashboard

🚀 Quick Start

Prerequisites

Node.js 16.x or higher
npm or yarn
Modern web browser

Installation

# Clone the repository
git clone https://github.com/busa0019/PantryChef.git

# Navigate to project directory
cd PantryChef

# Install dependencies
npm install

# Start development server
npm start

The application will open at http://localhost:3000

Build for Production

# Create production build
npm run build

# Deploy to GitHub Pages
npm run deploy

🛠️ Tech Stack

Frontend Framework

React 18 with TypeScript
Tailwind CSS for styling
Create React App for build tooling

Key Libraries

React Hooks for state management
LocalStorage for data persistence
React Icons for iconography

Development Tools

TypeScript for type safety
ESLint for code quality
PostCSS for CSS processing

📁 Project Structure

PantryChef/
├── public/                 # Static assets
├── src/
│   ├── components/        # React components
│   │   ├── Header.tsx
│   │   ├── Hero.tsx
│   │   ├── Features.tsx
│   │   ├── HowItWorks.tsx
│   │   ├── IngredientScanner.tsx
│   │   ├── RecipeFinder.tsx
│   │   ├── ShoppingList.tsx
│   │   ├── MethodsSection.tsx
│   │   ├── MethodCard.tsx
│   │   ├── CommunityQA.tsx
│   │   ├── DashboardPreview.tsx
│   │   ├── CommunitySection.tsx
│   │   ├── Footer.tsx
│   │   ├── LoadingSpinner.tsx
│   │   └── LoginModal.tsx
│   ├── App.tsx
│   ├── index.tsx
│   └── index.css
├── package.json
├── tailwind.config.js
├── tsconfig.json
└── README.md

🔑 Key Features in Detail

1. AI-Powered Recipe Matching

Ingredient-based search
Dietary filters (Vegetarian, Vegan, Keto, Gluten-Free)
Time-based filtering (under 30 minutes)
Match percentage scoring

2. Smart Shopping List

AI-generated grocery lists
Priority sorting for expiring items
Cost estimation
Category organization

3. Cooking Techniques Library

Step-by-step guides with pro tips
Difficulty levels
Video tutorials
Tool requirements

4. Community Engagement

Q&A forum
Recipe sharing
Waste reduction tracking
Expert contributors

♿ Accessibility Features

PantryChef follows WCAG 2.1 AA guidelines:

Semantic HTML
Full keyboard navigation
ARIA labels
4.5:1 minimum color contrast
Visible focus indicators
Descriptive alt text

📱 Responsive Design

Mobile-first approach
Breakpoints: sm, md, lg, xl
Touch-friendly UI
Performance optimized with lazy loading

🌱 Environmental Impact

Statistics Tracked

Food waste reduced
Money saved
CO₂ reduction
Recipes created

Sustainability Goals

Reduce food waste by 60%
Save resources
Educate users
Build a waste-conscious cooking community

🔧 Development

Available Scripts

npm start
npm test
npm run build
npm run deploy
npm run eject

Code Style

TypeScript (strict mode)
ESLint (Airbnb style guide)
Prettier formatting
Functional components with hooks

🤝 Contributing

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit changes (git commit -m 'Add AmazingFeature')
Push to branch (git push origin feature/AmazingFeature)
Open a Pull Request

📄 License

This project is licensed under the MIT License – see the LICENSE file for details.

🙏 Acknowledgments

Unsplash – Food photography
Tailwind CSS
React Community

📞 Support

Bugs: GitHub Issues
Features: GitHub Discussions
Questions: Open an issue

Built with ❤️ for sustainable cooking
_{Help reduce food waste, one meal at a time}

⭐ Star us on GitHub • 🍴 Fork the project • 🐛 Report a bug

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
public		public
src		src
.gitignore		.gitignore
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.js		tailwind.config.js
tsconfig.json		tsconfig.json

busa0019/PantryChef

Folders and files

Latest commit

History

Repository files navigation