Files
menulio/apps/mobile/PRODUCT.md
T
2026-08-20 01:51:59 +03:00

53 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 23 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.