🍗 Chicken Recipes AI

A free, open-source chicken recipe browser powered by TheMealDB. Host it for free on GitHub Pages!

✨ Features

• 🌐 Real Recipes — Fetches authentic chicken recipes from TheMealDB global database
• 🎯 Smart Filtering — Filter by region (Italian, Indian, Mexican...) and category (Breakfast, Starter, Main...)
• 📝 Full Details — Real ingredient measurements and step-by-step instructions
• 🎥 Video Tutorials — Links to YouTube cooking videos when available
• 💾 Save & Organize — Save favorites in browser localStorage (no account needed)
• 🖨️ Print Friendly — Clean print layout for kitchen use
• 📱 Responsive — Works on mobile, tablet, and desktop
• ⚡ Zero Cost — Free API, free hosting, no backend required

🚀 Deploy to GitHub Pages

Option 1: Direct Upload

1. Create a new repository on GitHub
2. Upload all files from this folder to the repository
3. Go to Settings → Pages
4. Under Source, select Deploy from a branch
5. Select main branch and /(root) folder
6. Click Save
7. Your site will be live at https://yourusername.github.io/repo-name/

Option 2: Git Command Line

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git
git push -u origin main

Then enable GitHub Pages in repository settings.

📁 File Structure

chicken-recipes-ai/
├── index.html          # Homepage
├── generator.html      # Recipe generator with filters
├── saved.html          # Saved recipes collection
├── about.html          # About & info page
├── css/
│   └── style.css       # All styles
├── js/
│   └── app.js          # API logic & recipe engine
└── README.md           # This file

🔧 How It Works

1. On page load, the app fetches all chicken recipes from TheMealDB: filter.php?i=chicken
2. When you select Region and/or Category and click Generate, it:
   • Picks random recipes from the chicken list
   • Fetches their full details
   • Checks if they match your selected region/category
   • Returns the first match (or a close alternative if no exact match)
3. Every recipe includes real ingredients, instructions, photos, and YouTube links

🔒 Privacy

All saved recipes are stored in your browser's localStorage. No data is ever sent to any server. Your recipe collection is completely private and stays on your device.

📝 License

MIT License — free to use, modify, and distribute.

🙏 Credits

• Recipe data: TheMealDB
• Fonts: Inter by Google Fonts