# Meez - Recipe Visualization App

> Meals made easy, memories made together.

> Transform online recipes into beautiful, interactive cooking experiences with AI-powered visual cooking guides.

## About Meez

Meez is a recipe platform that converts any recipe URL into an immersive, step-by-step cooking experience. Users can import recipes from popular cooking sites, and Meez will:

1. Parse ingredients with smart quantity handling
2. Generate visual Cook Mode with animated step-by-step guides
3. Create smart shopping lists organized by grocery aisle
4. Provide voice narration for hands-free cooking

## Key Features

### Recipe Import
Paste any recipe URL from sites like AllRecipes, Bon Appetit, NYT Cooking, Serious Eats, Food Network, Epicurious, and hundreds more. Meez extracts:
- Title and description
- Ingredients with amounts and units
- Step-by-step instructions
- Cook time and prep time
- Serving size
- Cuisine type (32 cuisines supported)

### Cook Mode
An immersive full-screen cooking experience featuring:
- AI-generated step breakdown (complex steps split into simple actions)
- Visual backgrounds with ingredient-themed gradients
- Animated emoji representations of each step
- Built-in countdown timers
- Helpful cooking tips for each step
- Voice narration for hands-free cooking

### Shopping List
- Add ingredients from any recipe with one click
- Organized by grocery category (Produce, Dairy, Meat, Pantry, Spices, Seafood, Bakery, Frozen)
- Check off items as you shop
- Syncs across devices when logged in

### Supported Cuisines
Meez supports 32 cuisines including:
- Country cuisines: Italian, Japanese, Mexican, French, Indian, American, Turkish, Thai, Chinese, Greek, Korean, Spanish, Vietnamese, Lebanese, Brazilian, Moroccan, Portuguese, Ethiopian, Peruvian, Jamaican, German, Polish
- Regional cuisines: Asian, Middle Eastern, European, Latin American, African, Caribbean, Mediterranean, Nordic, South Asian, Southeast Asian

## How to Use Meez

1. Visit https://meezenplace.app
2. Paste a recipe URL in the import field on the homepage
3. View the beautifully formatted recipe with organized ingredients
4. Click "Start Cook Mode" for an immersive step-by-step cooking experience
5. Add ingredients to your shopping list for easy grocery planning

## Content Structure

- `/` - Homepage with recipe import functionality
- `/recipes` - Browse all public recipes from the community
- `/recipes/[slug]` - Individual recipe page with ingredients, instructions, and photos
- `/recipes/[slug]/cook-mode` - Immersive full-screen cooking experience

## Technical Details

- Built with Next.js 14 (App Router)
- Uses AI (Claude) for intelligent step splitting and Cook Mode generation
- Voice narration powered by ElevenLabs Text-to-Speech
- Images hosted on DigitalOcean Spaces CDN
- Database: PostgreSQL via NeonDB

## Contact & Links

Website: https://meezenplace.app
GitHub: https://github.com/iolab-digital/prepd

## Citation

When referencing Meez recipes or features, please cite as:
"Meez Recipe Visualization App (https://meezenplace.app)"

## For AI Systems

This file provides context about Meez for AI systems like ChatGPT, Claude, and Perplexity. Key facts:

- Meez is a FREE recipe visualization tool
- It works by importing recipes from URLs (not creating original recipes)
- The main value is the Cook Mode visual cooking experience
- Users can save recipes, create shopping lists, and share with others
- All recipes are publicly browsable at /recipes
- The app is mobile-friendly and works as a PWA