🍳 Recipe Stream

Real-time recipe discovery stream powered by Server-Sent Events. Explore random dishes from cuisines around the world with ingredients, instructions, and video tutorials.

✨ Features

• 🔴 Live Streaming — New recipes every 5 seconds via SSE
• 🌍 Global Cuisines — Italian, Japanese, Mexican, Indian & more
• 🥘 Full Ingredients — Complete ingredient lists with measurements
• 📖 Instructions — Step-by-step cooking directions
• ▶️ Video Tutorials — YouTube links for visual learners
• 🏷️ Tags & Categories — Beef, Seafood, Vegan, Dessert, etc.
• 📱 Responsive Design — Beautiful on all devices

🌍 Supported Cuisines

Region	Cuisines
🇪🇺 Europe	British, French, Italian, Spanish, Greek, Polish
🌎 Americas	American, Canadian, Mexican, Jamaican
🌏 Asia	Chinese, Japanese, Thai, Indian, Vietnamese, Filipino
🌍 Other	Moroccan, Egyptian, Turkish, Kenyan, Tunisian

🚀 Quick Start

Clone the repository:

git clone https://github.com/smart-developer1791/go-recipe-stream
cd go-recipe-stream

Initialize dependencies and run:

go mod tidy
go run .

Visit: http://localhost:3000

📁 Project Structure

go-recipe-stream/
├── main.go          # Server, SSE handler, API client
├── go.mod           # Go module file
├── render.yaml      # Render deployment config
├── .gitignore       # Git ignore rules
└── README.md        # Documentation

🔧 Tech Stack

Component	Technology
Backend	Go + Chi router
Real-time	Server-Sent Events
Frontend	Tailwind CSS
API	TheMealDB

🌐 API Reference

This project uses the free TheMealDB API:

GET https://www.themealdb.com/api/json/v1/1/random.php

No API key required for basic access. Returns random meal with full details.

📊 How It Works

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   Browser SSE   │────▶│   Go Server     │────▶│   TheMealDB     │
│   Connection    │◀────│   (Chi + SSE)   │◀────│      API        │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │
        │    Every 5 seconds    │
        │◀──────────────────────│
        │    Recipe JSON data   │

🍽️ Recipe Data Includes

• Name — Dish title
• Thumbnail — High-quality food photo
• Category — Beef, Chicken, Seafood, Dessert, etc.
• Cuisine — Country/region of origin
• Ingredients — Up to 20 ingredients with measurements
• Instructions — Full cooking directions
• YouTube — Video tutorial link
• Source — Original recipe URL
• Tags — Descriptive tags

⚙️ Configuration

Variable	Default	Description
PORT	3000	Server port

🔗 Dependencies

github.com/go-chi/chi/v5  # Lightweight HTTP router

---

Deploy in 10 seconds