# Menu Mate

> Menu Mate is a Norwegian AI-powered meal planning application that generates personalized weekly meal plans, shopping lists, and recipe recommendations based on user preferences, dietary restrictions, and budget.

## About

Menu Mate (menumate.no) simplifies meal planning for Norwegian households. The application uses artificial intelligence to create customized meal plans tailored to each user's taste preferences, allergies, cooking time constraints, and budget. All content is in Norwegian (Bokmål).

## URL Structure

Public pages:
- `/` - Landing page with features overview
- `/om-oss` - About page (mission and values)
- `/blogg` - Blog with meal planning tips and recipes
- `/blogg/:slug` - Individual blog articles
- `/personvern` - Privacy policy
- `/vilkar` - Terms and conditions

User pages (requires login):
- `/dashboard` - Main dashboard for preferences and meal plan management
- `/meal-plan/:id` - Detailed meal plan view with recipes and shopping list
- `/saved-recipes` - Personal saved recipes collection
- `/recipe-history` - Complete history of all recipes with ratings
- `/account/settings` - Profile and collaborator management
- `/account/security` - Password management
- `/account/data` - Data export and deletion options

## Core Features

### Meal Plan Generation
AI-powered meal plan creation for 1-7 days with fully customizable preferences:

**Cuisine options:**
- Norwegian, Italian, Japanese, Indian, Chinese, Middle Eastern, Greek, Mexican, French, Thai
- Users can also add custom cuisines

**Dietary preferences:**
- Vegetarian, Vegan, Low-Carb, High-Protein, Healthy

**Flavor profiles:**
- Spicy, Mild, Sweet, Salty, Sour
- Custom flavor preferences supported

**Budget levels (per portion):**
- Budget: 40-70 NOK
- Normal: 60-90 NOK
- Gourmet: 100-150 NOK

**Cooking time options:**
- 20 minutes, 30 minutes, 45 minutes, 60+ minutes

**Portion sizes:**
- 1-12 servings

### Allergy Support
Full allergen management with 10+ predefined categories:
- Gluten, Dairy, Nuts, Eggs, Soy, Fish, Shellfish, Sesame, Mustard, Celery
- Custom allergies can be added

### Shopping List
- Automatically generated from all recipes in a meal plan
- Organized by category: Produce, Dairy, Meat & Fish, Pantry, Other
- Interactive checklist with persistent state
- Multi-column responsive layout

### Mate AI Assistant
In-recipe AI helper that provides:
- Ingredient substitutions
- Cooking tips and techniques
- Portion adjustments
- Allergy accommodations
- Step-by-step guidance

### Recipe Management
- Save favorite recipes to personal collection
- Search and filter saved recipes
- View complete recipe history with status tracking
- Rate recipes on ease, time accuracy, and taste
- Replace individual recipes while keeping the rest of the plan

### Collaboration
- Share meal plans with family and friends
- Two roles: Editor (Kokk) and Viewer (Gjest)
- Invitation system with expiration
- Accept or decline incoming invitations

## Unique Features

1. **Norwegian-first**: All UI and generated content in Norwegian (Bokmål)
2. **Leftover integration**: Register leftover ingredients and get bonus recipes that use them, reducing food waste
3. **Feedback loop**: Rate and review recipes to improve future recommendations
4. **Budget-aware generation**: Recipes respect your specified budget level
5. **Flexible customization**: Add unlimited custom cuisines, flavors, and allergies beyond presets
6. **Collaborative planning**: Share and co-edit meal plans with household members

## Blog Topics

The Menu Mate blog (menumate.no/blogg) covers:
- Meal planning strategies and tips
- Healthy eating advice
- Seasonal recipes and ingredients
- Food budgeting and saving tips
- Norwegian food culture and traditions
- Quick weeknight dinner ideas

## Machine-Readable Content

Menu Mate provides markdown versions of content for AI agents and crawlers.

### Content Negotiation

Request markdown content using either method:
1. **Accept Header:** Send `Accept: text/markdown` or `Accept: text/x-markdown`
2. **URL Extension:** Append `.md` to any supported URL

### Available Markdown Endpoints

**Blog Posts:**
- Individual posts: `https://menumate.no/blogg/{slug}.md`
- Blog listing: `https://menumate.no/blogg.md`

**Static Pages:**
- Privacy Policy: `https://menumate.no/personvern.md`
- Terms of Service: `https://menumate.no/vilkar.md`
- About: `https://menumate.no/om-oss.md`

### Content Format

All markdown content includes:
- YAML frontmatter with metadata (title, url, lang, date)
- Norwegian (Bokmål) language content
- Properly formatted headers, lists, and links

### Auto-Discovery

Each HTML page includes a discovery link:
```html
<link rel="alternate" type="text/markdown" href="...">
```

## Contact & Policies

- Website: https://menumate.no
- Blog: https://menumate.no/blogg
- Privacy Policy: https://menumate.no/personvern
- Terms of Service: https://menumate.no/vilkar