# YumMate.app - Comprehensive AI Documentation

## Overview

YumMate.app is a food content platform designed specifically for restaurants, food-trucks, ghost-kitchens, and catering services. The platform transforms simple food photos into professional 10-second hero-shot videos using advanced AI technology.

---

## Core Functionality

### Video Creation Workflow
1. **Upload**: User uploads a food photo (JPG, PNG, WEBP, max 10MB)
2. **AI Enhancement**: Replicate Seedream-4 enhances the image with professional lighting and styling
3. **Video Composition**: Shotstack API composes the final video with optional audio and text overlays
4. **Menu Boards**: Completed videos are displayed in digital menu boards with public URLs and QR codes

### Supported Aspect Ratios
- **9:16** - Mobile/Portrait (TikTok, Instagram Stories, Smartphones)
- **16:9** - Desktop/Landscape (Websites, Monitors, YouTube)
- **1:1** - Square (Instagram Feed, Facebook)

---

## AI Technologies

### Image Enhancement
- **Model**: Proprietary AI image enhancement pipeline
- **Method**: Image-to-Image enhancement with intelligent lighting and surface selection
- **Prompt Generation**: AI-powered structured prompt creation

### Enhancement Styles
| Style | Lighting | Surface | Use Case |
|-------|----------|---------|----------|
| Professional | Clean, bright, minimal | White/Light | Business Lunch, Cafés |
| Cinematic | Dark, dramatic, moody | Dark/Charcoal | Fine Dining, Premium |
| Gourmet | Luxury, refined | Dark/Premium | High-End Restaurants |
| Casual | Warm, approachable | Neutral/Beige | Fast Food, Family |
| Rustic | Natural, textured | Wood/Natural | Farm-to-Table, Organic |
| Lifestyle | Modern, fresh | Light/White | Health Food, Salads |

### Video Composition
- **Technology**: Shotstack API with template-based rendering
- **Features**: 
  - Camera movements (slider, zoom, static)
  - Text overlays (title, price)
  - Optional background audio
  - Professional color grading

---

## Subscription Plans

| Plan | Credits/Month | Price | Menu Boards | Best For |
|------|---------------|-------|-------------|----------|
| Breakfast | 8 | €29+VAT/month | 1 | Small cafés |
| Daily Menu | 18 | €59+VAT/month | 3 | Restaurants |
| Gourmet Menu | 35 | €99+VAT/month | Unlimited | Chains, high-volume |

### Credit System
- 1 Credit = 1 Video (includes enhancement + composition)
- Additional credits available for one-time purchase (€4.49+VAT/credit)
- Credits consumed via FIFO (First-In-First-Out)
- 🎁 15 free bonus clips on first plan activation

---

## Internationalization

### Supported Languages
- German (DE) - Default
- English (EN)
- Spanish (ES)
- Italian (IT)

### Features
- Full UI translation
- Automatic multilingual video title generation
- Language-specific hero videos on landing page

---

## Technical Architecture

### Frontend
- React 18.3 with TypeScript
- Vite build tool
- Tailwind CSS with HSL-based semantic tokens
- shadcn/ui component library (Radix UI primitives)
- React Query for state management
- React Router v6 for routing
- i18next for internationalization

### Backend (Supabase)
- PostgreSQL database with Row Level Security (RLS)
- Supabase Storage for videos, thumbnails, audio
- Deno-based Edge Functions for serverless logic
- Supabase Auth (Email/Password, Magic Links)
- Supabase Realtime for live status updates

### External Services
- **AI Pipeline**: Proprietary image enhancement, video generation, and music composition
- **Stripe**: Payment processing and subscription management
- **Resend API**: Transactional emails

---

## Menu Board System

### Features
- Playlist management with clip ordering
- Customizable display settings (auto-play, transitions, background color)
- Multiple layout types (Grid, Carousel)
- Public shareable URLs
- QR code generation for easy access
- Schedule-based display configuration

---

## Security & Compliance

### Data Protection
- EU-based infrastructure (GDPR compliant)
- Row Level Security (RLS) for all user data
- Secure payment processing via Stripe
- No personal data shared with AI providers

### Authentication
- Email/password authentication
- Magic link authentication
- Session management via Supabase Auth

---

## API & Integration

### REST API
YumMate.app provides a REST API that allows AI assistants and external systems to automate the full video creation workflow programmatically.

- **Authentication**: API key-based (SHA-256 hashed, managed in user profile)
- **Rate Limits**: 60 requests/minute
- **Capabilities**: Photo upload → AI enhancement → video generation → MenuBoard publishing
- **AI Assistant Support**: Skill-file download for OpenClaw, Claude, ChatGPT, and custom agents
- **Webhook Support**: Stripe payment events

### Integrations
- AI assistant automation (voice commands, bulk operations, seasonal updates)
- Stripe payment processing and subscription management
- Resend API for transactional emails

---

## Contact & Support

- **Website**: https://www.yummate.app
- **Help Center**: https://www.yummate.app/help
- **Terms of Service**: https://www.yummate.app/terms
- **Privacy & Imprint**: https://www.yummate.app/imprint
- **Security Reports**: security@yummate.app

---

## Version Information

- **Current Version**: 1.1
- **Last Updated**: March 2026
- **Platform**: Web Application (React SPA)
- **Mobile Support**: Responsive design, PWA-ready

---

## Keywords for AI Understanding

food video generation, restaurant marketing, AI food photography, digital menu boards, hero shot videos, food content creation, restaurant technology, menu digitization, food styling AI, video automation, hospitality tech, restaurant video marketing, food photography enhancement, menu display system, QR menu, food truck marketing, ghost kitchen content, catering videos