Skip to content

0daysleft/recipe-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

269 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🍽️ Meal Explorer – Dynamic Meal Search App

A modern, responsive web app that lets users explore delicious meals via TheMealDB API. Built with vanilla JavaScript, HTML5, and CSS3, this application fetches meals dynamically based on user input or displays default meals when no search is performed.


🔍 Live Preview

Vercel

GitHub Pages


🚀 Features

  • 🔎 Search for meals using TheMealDB's API
  • 🧠 Displays default meals on initial load (b-based meals as default)
  • Handles "no results" gracefully with helpful suggestions
  • 🎯 Responsive CSS Flexbox layout optimized for all screen sizes
  • 🧼 Clean and modular UI with scrollable instructions
  • 🛠️ Fully extendable for API expansion, like meal categories, random picks, or ingredient-based search
  • ✅ Has different sections of meals
  • 🧭 Good navigation sections

📁 Project Structure

.
├── index.html                  -                      # Main UI layout
├── html-files
              ├── meal-categories.html                 # All Meal Categories (eg, Beef, Chicken)
              ├── meal-category-type.html              # All Meal Categories Type(i.e If Meal category is Beef, All meals which are in beef type)
              ├── meal-details.html                    # Each Meal in details i.e measures, ingredients and cooking instructions;
├── styles
              ├── styles.css                           # Custom flexbox-based styling
├── script                                             # All JavaScript logic (API fetch, render, error handling)
              ├── meal-categories.js                   # each corresponding html files data
              ├── meal-category-type.js                # each corresponding html files data
              ├── script.js                            # most data is fetched from this script file;

🧑‍💻 Author

Built by 0 Day

Code until something cool happens.

🧪 Future Improvements (Ideas) Some will be added,removed, implemented and discerded, The future will tell

  • Ingredient-based filtering (🚧 In Progress)

  • Random meal generator button (🚧 🚧 Almost Done)

  • Category-based filtering (e.g., Vegan, Seafood, etc.) (🚧 🚧 Almost Done)

  • Add dark mode toggle (🚧 In Progress)

  • Use localStorage to cache recent searches (🚧 In Progress)

  • Filter by Area (🚧 🚧 Almost Done)

  • Filter by main ingredient (🚧 In Progress)

  • List all Categories, Area, Ingredients (🚧 Almost Done)

  • Lookup a single random meal (🚧 Almost Done)

  • Lookup full meal details (Done ✅)

  • List all meals by first letter (🚧 Almost Done)

🙏 Acknowledgments

LICENCE

This project is free to use, feel free to fork it and use it as you wish. Don't forget to star it as you fork it 🫡😎.

About

A simple web app built with HTML, CSS, and JavaScript to discover recipes. Integrates with the The MealDB API for detailed recipes, ingredients, and instructions. Search by ingredients, cuisine, or meal type, and save your favorites for easy access.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors