SERIO – Smart Ethiopian Recipe & Ingredient Optimizer: an AI-powered web app that generates Ethiopian recipes from your available ingredients.
# SERIO — Smart Ethiopian Recipe & Ingredient Optimizer
An AI-powered full-stack web application that generates authentic Ethiopian recipes based on ingredients available in your pantry.
---
## Screenshots
> Add screenshots of the Landing page, Dashboard, Recipe Generator, and Pantry here before submission.
---
## Tech Stack
| Layer | Technology |
|------------|-------------------------------------|
| Frontend | React 18, React Router, Tailwind CSS v3 |
| Backend | Node.js, Express 5 |
| Database | PostgreSQL (Neon serverless) |
| AI | Google Gemini API |
| Auth | JWT (jsonwebtoken + bcryptjs) |
| Security | Helmet, express-rate-limit, CORS |
---
## Features
- 🍽️ **AI Recipe Generation** — Generate authentic Ethiopian recipes from your pantry
- 🥦 **Smart Pantry** — Track ingredients, quantities, expiry dates and running-low alerts
- 📅 **Meal Planner** — Weekly Ethiopian calendar view with drag-and-drop meal scheduling
- 🛒 **Shopping List** — Auto-generated from meal plans, move items to pantry when done
- 📊 **Dashboard** — Live stats, upcoming meals, expiring ingredients
- 🌍 **Bilingual** — Full English / አማርኛ (Amharic) support with Ethiopian calendar dates
- 🔐 **Auth** — JWT authentication with admin role support
- ⚙️ **Settings** — Dietary preferences, allergies, cuisine preferences, language
---
## Project Structure
```
SERIO-PERN/
├── Client/
│ └── ai-recipe-generator/ # React + Vite frontend
│ ├── src/
│ │ ├── pages/ # All page components
│ │ ├── components/ # Navbar, ProtectedRoute, etc.
│ │ ├── context/ # Auth, Language, Theme contexts
│ │ ├── services/ # Axios API service
│ │ └── assets/ # Images and video
│ └── .env.example
│
└── Server/ # Express backend
├── controllers/ # Business logic
├── routes/ # API r …