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.
Live flow
Prospect meeting sequence
- Start at the owner story
Confirm the persistent demo banner is visible before you pitch.
Open sales page - Scan QR or open the menu
Show the QR card, then scan it or use the fallback menu link.
Open menu - Customize a platter
Choose Combo Over Rice, select sauces, spice, and an extra.
Customize platter - Show repeat-order value
Save the configured item as a local demo favorite.
Save favorite - Preview demo reorder
Reorder the saved favorite into the browser-local demo cart.
Reorder favorite - Open checkout preview
Review item quantities and totals without collecting any data.
Open checkout preview - Show fake status preview
Generate the fake DEMO-0001 receipt/status preview.
Preview receipt - Show PWA positioning
Explain that install behavior varies by platform and browser.
Show install guide
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, payment service, 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.
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 receipt/status preview. Anything involving real orders, payment, customer identity, delivery, admin operations, or persistence belongs in a later scoped sprint.