Skip to content

DarshanKumarGP/MEAL-MATE

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

18 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🍽️ MEAL-MATE

MEAL-MATE Logo

A Modern Full-Stack Food Delivery Platform

Connecting hungry customers with delicious restaurants through seamless technology

Live Demo GitHub Stars License PRs Welcome


🌟 Project Overview

MEAL-MATE is a production-ready, full-stack food delivery platform that revolutionizes the way people discover, order, and enjoy food. Built with modern technologies and industry best practices, it provides a seamless experience for customers, restaurant owners, and administrators.

🎯 Key Highlights

  • πŸ” Secure Authentication - JWT-based multi-role authentication system
  • πŸ’³ Payment Integration - Razorpay payment gateway with webhook support
  • πŸ“± Responsive Design - Mobile-first approach with beautiful UI/UX
  • ⚑ Real-time Updates - Live order tracking and status updates
  • πŸ“Š Analytics Dashboard - Comprehensive business intelligence for restaurants
  • πŸͺ Multi-tenant Architecture - Support for multiple restaurants and users

πŸ› οΈ Tech Stack

Frontend

React TypeScript React Router

Backend

Django Django REST Python JWT

Database

PostgreSQL

Payment & Tools

Razorpay Git GitHub VS Code Postman


✨ Features

πŸ‘₯ For Customers

  • πŸ” Smart Restaurant Discovery – Location-based search/filter
  • πŸ“‹ Menu Browsing – Rich display, images, categories
  • πŸ›’ Cart Management – Add, modify, checkout
  • πŸ’³ Secure Payment – Razorpay integration
  • πŸ“± Order Tracking – Real-time updates
  • ⭐ Review & Rating – Leave feedback, view others'
  • πŸ“œ Order History – Access/reorder previous orders

πŸͺ For Restaurant Owners

  • πŸ“Š Dashboard – Real-time analytics & metrics
  • 🍽️ Menu Management – CRUD with images, categories, status
  • πŸ“‹ Order Processing – Accept, update, view live
  • πŸ’° Revenue Analytics – Track performance
  • πŸ”” Notifications – Get instant order alerts

πŸ‘¨β€πŸ’Ό For Admins

  • πŸŽ›οΈ User/Restaurant Management
  • πŸ“Š Platform Analytics
  • πŸͺ Restaurant Approval
  • πŸ›‘οΈ Security Controls

πŸ—οΈ Project Structure

MEAL-MATE/ β”œβ”€β”€ backend/ # Django REST API β”‚ β”œβ”€β”€ apps/ β”‚ β”‚ β”œβ”€β”€ authentication/ β”‚ β”‚ β”œβ”€β”€ core/ β”‚ β”‚ β”œβ”€β”€ restaurants/ β”‚ β”‚ β”œβ”€β”€ orders/ β”‚ β”‚ β”œβ”€β”€ payments/ β”‚ β”‚ └── notifications/ β”‚ β”œβ”€β”€ config/ # Django settings β”‚ β”œβ”€β”€ media/ # User-uploaded files β”‚ └── requirements.txt β”œβ”€β”€ frontend/ # React TypeScript β”‚ β”œβ”€β”€ public/ β”‚ β”œβ”€β”€ src/ β”‚ β”‚ β”œβ”€β”€ components/ β”‚ β”‚ β”œβ”€β”€ pages/ β”‚ β”‚ β”œβ”€β”€ context/ β”‚ β”‚ β”œβ”€β”€ services/ β”‚ β”‚ β”œβ”€β”€ styles/ β”‚ β”‚ └── utils/ β”‚ └── package.json β”œβ”€β”€ README.md └── LICENSE


πŸš€ Quick Start

Requirements:

  • Python 3.8+
  • Node.js 16+
  • Git

Clone & Run:

git clone https://github.com/DarshanKumarGP/MEAL-MATE.git cd MEAL-MATE Backend: cd backend python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate pip install -r requirements.txt python manage.py makemigrations python manage.py migrate python manage.py createsuperuser # Optional python manage.py runserver

Frontend: cd ../frontend npm install npm start

Environment Variables

  • Backend: .env file for secrets, DB, Razorpay keys
  • Frontend: .env for API URL & payment key

🎯 Key Features in Detail

πŸ” Auth System

  • Multi-role with JWT
  • Role-based authorization

πŸ’³ Payment

  • Razorpay integration
  • Webhook handling

πŸ“Š Analytics

  • Real-time dashboard
  • Order/revenue trends

πŸ—οΈ Architecture

  • RESTful API, modular frontend/backend
  • Type-safe codebase

🀝 Contributing

Fork the repo and clone

Create feature branch: git checkout -b feature/YourFeature

Commit your changes: git commit -m "Add awesome feature"

Push: git push origin feature/YourFeature

Open Pull Request

See CONTRIBUTING.md for style and test guidelines!


πŸ“œ API Endpoints

Auth

  • POST /api/auth/register/
  • POST /api/auth/login/

Restaurants

  • GET /api/restaurants/
  • GET /api/restaurants/{id}/menu-items/

Orders

  • POST /api/orders/
  • GET /api/orders/

Cart

  • GET /api/cart-items/
  • POST /api/cart-items/

πŸš€ Deployment

  • Backend: Cloud (AWS, DigitalOcean), set up .env, database, HTTPS
  • Frontend: Build (npm run build), deploy to Vercel/Netlify
  • Docker: Use docker-compose up --build for local full-stack

πŸ§ͺ Testing

  • Backend: python manage.py test
  • Frontend: npm test

πŸ›‘οΈ Security

  • HTTPS, CSRF, secure headers
  • JWT authorization everywhere
  • Parameterized queries and sanitization

πŸ“ˆ Future Enhancements

  • πŸ€– AI-powered recommendations
  • πŸ“± Mobile (React Native/PWA)
  • 🌐 Multi-language
  • πŸ”” Push notifications
  • πŸ“ Geo-tracking/delivery tracking
  • πŸ’¬ In-app chat/support

πŸ™ Acknowledgments

  • Django/React communities, OSS contributors, UI inspiration from top food delivery platforms

πŸ“„ License

MIT License β€” see the LICENSE file.


πŸ‘¨β€πŸ’» Developer

Darshan Kumar GP

GitHub | LinkedIn | darshankumargp18@gmail.com


⭐ Star This Repo!

If you learned or gained from this project, please star and share!


Building the future of food delivery, one commit at a time πŸš€

About

Meal-Mate 🍽️ β€” A full-stack food delivery platform built with Django REST & React (TypeScript). Features real-time order tracking, secure JWT auth, restaurant discovery, seamless payments, and a beautiful, responsive UI. Perfect for learning, experiments, and rapid production! πŸš€

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors