https://github.com/ellis3684/bitefinder
A full-stack calorie-based meal recommendation web app. Users input their calorie limit, find nearby restaurants, and get meal suggestions that fit their budget.
https://github.com/ellis3684/bitefinder
api-integration calorie-tracking celery django django-rest-framework docker fatsecret-api foursquare-api fullstack health-and-fitness location-based-services meal-recommendation nutrition postgresql react redis restaurant-finder vite web-application
Last synced: 2 months ago
JSON representation
A full-stack calorie-based meal recommendation web app. Users input their calorie limit, find nearby restaurants, and get meal suggestions that fit their budget.
- Host: GitHub
- URL: https://github.com/ellis3684/bitefinder
- Owner: ellis3684
- Created: 2025-06-25T17:25:58.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-10-21T14:07:43.000Z (8 months ago)
- Last Synced: 2026-04-07T07:43:56.260Z (2 months ago)
- Topics: api-integration, calorie-tracking, celery, django, django-rest-framework, docker, fatsecret-api, foursquare-api, fullstack, health-and-fitness, location-based-services, meal-recommendation, nutrition, postgresql, react, redis, restaurant-finder, vite, web-application
- Language: Python
- Homepage:
- Size: 145 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# BiteFinder 🍴
A full-stack web app that helps users find meal combinations from nearby restaurants that fit within their calorie budget.
👉 **Live Demo:** [https://bitefinder.dev](https://bitefinder.dev)
👉 **Backend API Docs:** [https://bitefinder.dev/api/docs/](https://bitefinder.dev/api/docs/)
---
## 🧑💻 About the Project
**BiteFinder** helps users answer the question:
**"What can I eat nearby that fits my calorie limit?"**
Users enter a calorie target, browse nearby restaurants, and get meal recommendations from real menu items, pulled from external restaurant APIs.
The app combines:
- Location-based restaurant search (via **Foursquare Places API**)
- Menu item and calorie data (via **FatSecret API**)
- A local heuristic algorithm for calorie-based meal recommendation (no AI or ML)
---
## 🚀 Features
✅ Live demo deployed at [https://bitefinder.dev](https://bitefinder.dev)
✅ Auto-generated **Backend API Docs** available at [https://bitefinder.dev/api/docs/](https://bitefinder.dev/api/docs/)
✅ Search nearby restaurants by location
✅ Browse real menu items with calorie info
✅ Get meal suggestions that fit your calorie limit
✅ Supports both chain and non-chain restaurants
✅ REST API backend (Django + DRF)
✅ React frontend (Vite + Tailwind CSS)
✅ Fully Dockerized for development
✅ Background tasks powered by Celery + Redis
---
## 🛠️ Tech Stack
| Layer | Tools |
|--------------|---------------------------------------|
| Backend | Django, Django REST Framework, Celery |
| Frontend | React (Vite, Tailwind CSS) |
| Database | PostgreSQL |
| Caching/Queue| Redis |
| APIs Used | FatSecret API, Foursquare Places API |
| Containerization | Docker + Docker Compose |
---
## ⚙️ Setup Instructions
### Prerequisites:
- Docker
- Docker Compose
- FatSecret API credentials
- Foursquare API credentials
---
### Development Setup:
```bash
# Clone the repo
git clone https://github.com/ellis3684/bitefinder.git
cd bitefinder
# Build and run Docker containers
docker-compose up --build