Skip to content

Repository files navigation

🍳 Smart Recipe Preparation Agent

Live Demo React TypeScript Vite Tailwind CSS

Smart Recipe Preparation Agent is an intelligent, AI-powered culinary companion designed to streamline home cooking. It assists users with ingredient-based recipe discovery, automated step-by-step preparation workflows, dynamic dietary customizations, and smart meal planning.

πŸ”— Live Application: https://recipepreparationagent.netlify.app/


✨ Key Features

  • 🧠 Smart Ingredient Matching: Input the ingredients available in your pantry to instantly discover tailored recipes and minimize food waste.
  • πŸ‘¨β€πŸ³ Interactive Step-by-Step Preparation: Real-time cooking guidance with timers, instructions, and preparation checkpoints.
  • πŸ₯— Dietary & Nutrition Customization: Filter recipes by dietary preferences (Vegan, Keto, Gluten-Free, High Protein) and view detailed nutritional breakdowns.
  • πŸ“… Meal Planning & Shopping Lists: Generate automated weekly meal schedules and export smart grocery lists.
  • 🎨 Modern & Accessible UI: Clean, responsive, dark/light compatible design powered by Tailwind CSS, Radix UI, and Material UI components.

πŸ› οΈ Technology Stack

Layer Technology
Frontend Framework React 18
Language TypeScript
Build Tool Vite
UI Components & Icons Radix UI, Shadcn UI, Material UI, Lucide React
Styling Tailwind CSS, Emotion
Deployment Netlify

πŸ“‚ Project Structure

SmartRecipePreparationAgent/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/                # Main application pages & layout
β”‚   β”œβ”€β”€ components/         # Reusable UI elements (cards, dialogs, timers)
β”‚   β”œβ”€β”€ imports/            # Core business logic, icons & styling imports
β”‚   β”œβ”€β”€ styles/             # Global CSS and theme configuration
β”‚   β”œβ”€β”€ index.html          # HTML entry point
β”‚   └── main.tsx            # Application root entry
β”œβ”€β”€ guidelines/             # Architectural specs and project guidelines
β”œβ”€β”€ package.json            # Dependencies and npm scripts
β”œβ”€β”€ vite.config.ts          # Vite build configuration
└── README.md

πŸš€ Getting Started Locally

Prerequisites

  • Node.js (v18.0.0 or higher recommended)
  • npm / pnpm / yarn

Installation

  1. Clone the repository:

    git clone https://github.com/preyal2/SmartRecipePreparationAgent.git
    cd SmartRecipePreparationAgent
  2. Install dependencies:

    npm install
  3. Start the local development server:

    npm run dev
  4. Open in browser: Navigate to http://localhost:5173 to view the app.

Building for Production

npm run build

🌟 Author

About

🧠 Autonomous Culinary AI Agent built with TypeScript, React 19 & Vite β€” featuring multi-step LLM reasoning, intelligent dietary constraint solving, real-time ingredient substitution, and smart meal planning.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

Generated from figma/repo-template