# Product

<!-- impeccable:product-schema 1 -->

## Platform

adaptive

## Users
- **Primary Users**: Restaurant owners, cafe managers, and hospitality operators.
- **Situation & Job**: Managing dining establishments and menu updates on-the-go directly from their smartphones. Key jobs include photographing physical paper menus, extracting items via AI, editing dishes/categories/pricing, styling public QR menus, generating table QR codes, and toggling item availability without needing a desktop admin panel.

## Product Purpose
Menulio turns physical paper menus into high-quality, responsive digital QR menus in 2–3 minutes using AI vision extraction on mobile. It empowers independent restaurants to ditch clunky PDF QR codes and expensive agency retainers with a modern, mobile-only management experience.

## Positioning
A mobile-first, AI-driven QR menu SaaS. While customers enjoy a fast, lightweight mobile web menu (zero app install required), restaurant owners manage 100% of their operations, menus, design templates, and QR assets directly inside a native mobile app.

## Operating Context
- Fast-paced restaurant environments: dining rooms, kitchens, counters, and outdoor patios.
- Capturing physical menus under mixed lighting (glare, low light, shadows, multi-page folds).
- Frequent operational micro-tasks: 86ing sold-out items, adjusting prices, adding daily specials.
- Exporting and sharing high-resolution QR assets for print stands, table stickers, and social media.

## Capabilities and Constraints
- **Stack**: Expo (SDK 52, New Architecture, Expo Router v4, React Native 0.76), Supabase (Auth, DB, Storage), Fastify API backend.
- **AI Extraction Flow**: Photo capture/upload → OCR & LLM extraction → Interactive Review step → Theme selection → Publish.
- **Menu Hierarchy**: Multi-restaurant support, Categories, Items, Variants/Addons, Pricing, Badges (Spicy, Vegan, Chef Special, etc.), Availability flags.
- **QR & Subdomains**: Dynamic unique subdomains per restaurant (`slug.menulio.com`) and customizable QR code downloads.
- **Constraint**: Admin web panel is out of scope for V1; all management features must exist within the mobile app.

## Brand Commitments
- **Name**: Menulio
- **Voice & Tone**: Clean, efficient, trustworthy, modern hospitality tech.
- **Design Standard**: Frictionless mobile ergonomics, tactile feedback, generous touch targets, clear typographic hierarchy.

## Evidence on Hand
- PRD: [AI_QR_Menu_SaaS_PRD.md](file:///Users/ayrisdev/Github/menulio/docs/AI_QR_Menu_SaaS_PRD.md)
- Roadmap: [ROADMAP.md](file:///Users/ayrisdev/Github/menulio/docs/ROADMAP.md)
- Schema: `supabase/migrations/`
- App entry & screens: `apps/mobile/src/app/`

## Product Principles
1. **Three-Minute Value**: From opening the app to scanning a live, generated QR code must take under 3 minutes.
2. **AI Suggests, Owner Decides**: AI extraction results are never auto-published without an explicit, effortless verification step.
3. **True Mobile Ergonomics**: Every management screen is designed for one-handed thumb interaction with platform-native affordances and standard navigation stacks.
4. **Zero Friction for Diners**: The customer experience requires zero app downloads, instant loads, and effortless filtering across dietary needs.

## Accessibility & Inclusion
- Adherence to platform touch targets (minimum 44×44pt on iOS, 48×48dp on Android).
- Proper text scaling with Dynamic Type (iOS) / sp units (Android).
- High contrast color pairs legible in both dim dining rooms and bright outdoor terraces.
