first commit

2026-08-20 01:51:59 +03:00
commit 97b83c7fd4
109 changed files with 21215 additions and 0 deletions
@@ -0,0 +1,52 @@
+# 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.