Founder live-demo runbook
Run the public demo with guardrails visible
Use this checklist before and during owner conversations for Harbor Halal Platters. Demo business - no real orders or payments. This runbook does not contain secrets, customer data, private prompts, or real operating instructions for a restaurant.
30-second pitch
Lead with the business value
- Harbor Halal Platters is a fictional public demo showing how a halal cart, food truck, or small restaurant could present its own branded web app experience.
- A customer can scan a QR code, browse the menu, customize a platter, preview a local demo favorite, and review receipt/status/communication concepts without this demo placing a real order.
- A paid client version would replace the fictional brand with the owner's real logo, menu, photos, policies, and any separately approved future ordering workflow.
2-minute walkthrough
Keep the demo moving
- 0:00-0:20: Set context
Open the sales page, point out the demo warning, and explain that this is a public-safe example, not a live restaurant system.
- 0:20-0:50: Show brand and menu
Scan the QR or open the menu, then pause on the premium food images, categories, tags, and item pricing.
- 0:50-1:30: Show customer flow
Customize a platter, preview it as a local favorite, reorder it into the demo cart, and show the local-only total.
- 1:30-2:00: Close with value
Preview the checkout review, continue to the fake status timeline, show the static communication preview, then review install guidance and explain what would be scoped for a real client.
Route-by-route flow
Prospect meeting sequence
- Start with the brand presence
Open the homepage first so the prospect sees the polished brand, food direction, and global demo banner before any flow.
Talk track: This is the kind of first impression your own branded web app could make from a QR code, Google profile, or social link.
Review home - Move to the owner story
Use the sales page as the founder control room for the QR, reset tool, and owner value story.
Talk track: This page is for the live walkthrough, not a customer checkout screen.
Review sales page - Orient with the flow map
Open the flow map when you want the whole fake product journey in one place before rehearsing route-by-route.
Talk track: This is an internal founder map only. It shows the demo order and future adapter seams without adding live product behavior.
View demo flow map - Scan QR or open the menu
Show the QR card, then scan it or use the fallback menu link to open the menu.
Talk track: Picture this QR on the cart window, menu board, receipt, catering flyer, or Instagram bio.
Preview menu - Show the menu presentation
Pause on the item cards, food imagery, categories, tags, and prices before customizing.
Talk track: A direct app-like menu can make a small operation look organized, modern, and easier to trust.
Show menu photos - Customize a platter
Choose Combo Over Rice, select sauces, spice, and an extra.
Talk track: This is only a pricing and modifier preview, but it shows the kind of lower-friction customer path a real build could support.
Customize platter - Show repeat-order value
Add the configured item to the local demo favorites preview.
Talk track: Favorites and reorder can help regulars repeat their usual meal without adding accounts in this demo.
Preview local favorite - Preview demo reorder
Reorder the local demo favorite into the browser-local demo cart.
Talk track: The cart is a local preview only, which keeps this public demo safe while still showing the customer flow.
Reorder favorite - Preview checkout review
Review item quantities and totals without collecting any data.
Talk track: Use the words checkout preview, not live checkout. Nothing is submitted or sent to a kitchen.
Preview checkout review - Show fake status preview
View the fake HHP-DEMO-1042 confirmation and status timeline.
Talk track: This shows the confirmation/status concept while making it unmistakable that no real order exists or reaches a kitchen.
View static status - Show static communication preview
View the static customer communication preview and no-payment receipt-style summary.
Talk track: No messages are sent here. This shows future communication concepts with fake channel labels and no contact data.
View notification preview - Show PWA positioning
Explain that install behavior varies by platform and browser.
Talk track: This is PWA add-to-home-screen positioning, not an App Store or Play Store native app promise.
Show install guide - Show the owner preview
Preview the static owner story, then the operations preview, and point out the fake metrics, fake status cards, static menu editor shape, and future scoped work list.
Talk track: This is not a live admin dashboard. These fake-data-only views help owners picture future operational value without real staff tools.
Preview owner story - Show static insights preview
Open the static insights preview to show future reporting and promo-readiness concepts.
Talk track: This is fake reporting only. There are no analytics keys, customer tracking, report exports, coupon redemptions, or campaign controls.
Preview insights - Show prep handoff concept
Preview the static prep handoff paired to the same fake HHP-DEMO-1042 reference.
Talk track: This is a kitchen ticket concept only. There are no print tools, status controls, staff sessions, or live kitchen routing.
Preview prep handoff - Close with the leave-behind
Review the leave-behind page and explain that it is a static follow-up summary the founder can revisit after the meeting.
Talk track: This is a recap page only. It has no forms, lead capture, tracking, or live operations.
Review leave-behind - Connect it back to owner value
Close on what would be customized for the owner's real business.
Talk track: A client version would need their real menu, brand assets, policies, operations, and any approved transaction scope.
Return to sales page
Owner questions
Simple objection answers
- Is this a real app?
This is a real web app demo running publicly, but Harbor Halal Platters is a fictional business and the flow intentionally does not place orders or collect money.
- Can this work for my business?
Yes, the point is to show how the same branded web-app structure could be customized for a halal cart, food truck, or small restaurant after scoping the real menu and operations.
- Can customers install it?
Customers can save supported web apps to their home screen from many browsers. The exact install prompt varies by iPhone, Android, desktop, and browser.
- Can I use my own logo, menu, and photos?
Yes. A client version would use the owner's real logo, color direction, menu, pricing, photos, disclaimers, and operating rules.
- Can real transactions or orders be added later?
They can be scoped later, but they are not live in this public demo. Real transaction handling, order routing, admin tools, privacy copy, and kitchen operations would need separate approval and implementation.
Discovery prompts
Questions to ask the owner
- Where do customers usually find your menu today: QR, Google, Instagram, paper menus, phone calls, marketplace pages, or walk-up ordering?
- Which items, modifiers, sauces, photos, and prices would need to look best in a branded demo for your shop?
- Would regulars benefit more from fast reorder, favorites, catering interest, or add-to-home-screen reminders?
- What parts of the customer experience feel painful today: menu confusion, repeat questions, missed calls, long lines, or reliance on third-party pages?
- If this became a paid client build, what would need to be approved first: logo, menu accuracy, operations flow, privacy copy, future ordering scope, or staff workflow?
After the conversation
Collect notes outside the app
- Business name spelling, preferred brand tone, and any existing logo or color direction.
- Menu categories, best sellers, modifier rules, and which item photos should be prioritized.
- Where the QR would live: cart window, truck wrap, counter sign, receipt, catering flyer, or social profile.
- Owner priorities for a later scoped build, such as future direct ordering workflow, staff-facing controls, coupons, or catering interest.
- Follow-up owner contact details in your own notes or CRM after the conversation, never inside this public demo app.
Do not type prospect details into this public demo. Keep any real follow-up notes in your normal business records outside the app.
Before staging
Public demo readiness checks
- Run `npm run validate`, `npm run test:e2e`, `npm run test:a11y`, and `npm run test:visual` before a public demo.
- Run `npm audit --audit-level=moderate` before publishing a staging build.
- Smoke the public URL with `npm run smoke:public -- <public-demo-url>` after deployment.
- Confirm the QR code uses the public browser origin and opens `/menu`.
- Confirm install guidance stays demo-only on iOS Safari, Android Chrome, and desktop Chrome or Edge.
- Confirm local storage only contains harmless demo cart, favorite, and loyalty preview keys.
- Keep generated screenshots in `artifacts/visual-qa/`; do not upload them as source or handoff zip contents.
Expected public behavior
Safe staging expectations
- No database, transaction processor, customer account, admin login, or external API is required for this demo.
- The QR card should encode only the current browser origin plus `/menu`.
- PWA install prompts may vary; the install guide should stay honest about manual fallback steps.
- Demo warnings should be visible on public-facing pages before any customer-flow interaction.
- All favorites, reorder, loyalty, cart, and receipt preview state remains browser-local.
- Notification and prep ticket previews remain static fake data with no message delivery, print tools, staff controls, or stored order records.
- Insights and promo-readiness previews remain static fake data with no analytics, tracking, report exports, coupon redemption, or campaign controls.
Founder demo tools
Reset local demo state
Clears only this app's browser-local demo cart, favorites, and loyalty preview keys. It does not contact a server or erase real customer data.
Ready to clear only Harbor Halal local demo keys.
Local demo keys cleared
harbor-halal-demo-cart-previewharbor-halal-demo-local-favoritesharbor-halal-demo-loyalty-preview
Do not improvise beyond the demo
Keep the pitch focused on what the static demo proves today: branded mobile ordering feel, QR access, install positioning, local favorites, and a fake status preview. Anything involving real orders, transaction handling, customer identity, delivery, admin operations, or persistence belongs in a later scoped sprint.