Skip to content

mdiibrahim/meal-app

Repository files navigation

🍽️ Meal Finder App

This is a responsive web application for a restaurant that allows users to explore, search, and discover meals using the free TheMealDB API.


🔗 Live Demo

👉 https://meal-app-drab-two.vercel.app/


📝 Project Description

The Meal Finder is built with React.js, Redux Toolkit (RTK Query), Tailwind CSS, and TypeScript. It allows users to:

  • Search meals by name or first letter
  • Filter results by category and area
  • View random meals
  • Bookmark favorite meals (stored in localStorage)
  • Browse featured meals through a carousel

🚀 Technologies Used

  • React.js (Vite)
  • Redux Toolkit (with RTK Query)
  • Tailwind CSS
  • TypeScript
  • Swiper.js
  • React Router
  • Axios
  • LocalStorage

🎯 Key Features

✅ Core Features

  • 🔍 Search meals by name or first letter
  • 🎲 Discover random meals
  • 🍱 Meal details with image, category, area, instructions
  • 📌 Bookmark favorite meals (saved in localStorage)
  • 📂 Filter by category and area
  • 🌐 Navigation across pages

💎 Bonus Features

  • ✅ TypeScript integration
  • ✅ RTK Query for API management
  • ✅ Bookmark/favorite meals system
  • ✅ Carousel for featured meals
  • ✅ Client-side filtering with dropdowns
  • ✅ Clean and responsive design

🛠️ Setup Instructions

  1. Clone the repository:
git clone https://github.com/mdiibrahim/meal-app.git
cd meal-app
  1. Install dependencies:
npm install
  1. Start development server:
npm run dev
  1. To build for production:
npm run build

About

A responsive restaurant meal explorer app built with React, Redux Toolkit, TypeScript, and Tailwind using TheMealDB API.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors