React Native · Expo SDK 57 · TypeScript

A pickup-preorder app for one restaurant, as real iOS and Android source.

Menu search and allergen filters, dish options that enforce their own rules, a docket that adds up in whole cents, and pickup slots that know the kitchen's hours, time zone and capacity. Orders are saved on the phone as clearly labelled local demo orders until you connect your own POS.

PlatformsiOS 16.4+ · Android 7.0+
StackRN 0.86 · Expo Router
Screens10 + allergen sheet
Tests77 Jest tests

Install and run What is and isn't included

Menu screen on iPhone: Fennick Kitchen header with open status, search, filters and a featured pinsa photo — iOSMenu

Dish options on Android: sesame poke bowl with base and protein chosen and the running price on the add button — AndroidDish options

Screens

The running app, both platforms

Captured with automated Maestro flows from release builds. Switch platform to compare.

iOS: First run: steps, allergen preference and the local-demo notice — iOSFirst run: steps, allergen preference and the local-demo notice

iOS: Menu with open status, search, filters and a featured dish — iOSMenu with open status, search, filters and a featured dish

iOS: Sticky section rail while scrolling the menu — iOSSticky section rail while scrolling the menu

iOS: A required group highlighted after an incomplete add — iOSA required group highlighted after an incomplete add

iOS: Choices made; the add button carries the price — iOSChoices made; the add button carries the price

iOS: Docket: lines, edit, quantity, totals in cents — iOSDocket: lines, edit, quantity, totals in cents

iOS: Pickup: ASAP or a 15-minute slot with capacity — iOSPickup: ASAP or a 15-minute slot with capacity

iOS: Field errors next to the fields — iOSField errors next to the fields

iOS: Ticket saved on the phone, stamped LOCAL DEMO — iOSTicket saved on the phone, stamped LOCAL DEMO

iOS: Upcoming and past orders — iOSUpcoming and past orders

iOS: Kitchen: hours in the restaurant's time zone, preferences, data — iOSKitchen: hours in the restaurant's time zone, preferences, data

iOS: Dark appearance: menu — iOSDark appearance: menu

iOS: Dark appearance: dish options — iOSDark appearance: dish options

iOS: Dark appearance: pickup — iOSDark appearance: pickup

iOS: Largest accessibility text size: pickup — iOSLargest accessibility text size: pickup

Android: First run: steps, allergen preference and the local-demo notice — AndroidFirst run: steps, allergen preference and the local-demo notice

Android: Menu with open status, search, filters and a featured dish — AndroidMenu with open status, search, filters and a featured dish

Android: Sticky section rail while scrolling the menu — AndroidSticky section rail while scrolling the menu

Android: A required group highlighted after an incomplete add — AndroidA required group highlighted after an incomplete add

Android: Choices made; the add button carries the price — AndroidChoices made; the add button carries the price

Android: Docket: lines, edit, quantity, totals in cents — AndroidDocket: lines, edit, quantity, totals in cents

Android: Pickup: ASAP or a 15-minute slot with capacity — AndroidPickup: ASAP or a 15-minute slot with capacity

Android: Field errors next to the fields — AndroidField errors next to the fields

Android: Ticket saved on the phone, stamped LOCAL DEMO — AndroidTicket saved on the phone, stamped LOCAL DEMO

Android: Upcoming and past orders — AndroidUpcoming and past orders

Android: Kitchen: hours in the restaurant's time zone, preferences, data — AndroidKitchen: hours in the restaurant's time zone, preferences, data

Android: Dark appearance: menu — AndroidDark appearance: menu

Android: Dark appearance: dish options — AndroidDark appearance: dish options

Android: Dark appearance: pickup — AndroidDark appearance: pickup

Android: Largest accessibility text size: pickup — AndroidLargest accessibility text size: pickup

Three customer journeys

What actually works on the device

Discover the menu

Search across dish names and ingredients.
Filter vegetarian or vegan; hide dishes with chosen allergens.
Open a dish for ingredients and illustrative allergen information; deep links open dishes directly.

Menu scrolled to the morning plates and bowls with the sticky section rail

Roast tomato soup opened from a deep link

Customise with rules

Required groups say so; the add button names the missing choice and jumps to it.
Single and multi-choice limits, sold-out options and price changes.
The docket merges identical lines, edits, undoes removals and totals in cents.

Sesame poke bowl with the base group highlighted as required

Docket with three items, subtotal, sales tax and total

Plan pickup, place a local demo order

ASAP or a 15-minute slot within opening hours, lead time, breakfast windows and capacity.
Name and phone are validated next to the fields; the slot is re-checked at the moment of ordering.
The ticket is saved on the phone, survives restarts and can be reordered.

Pickup checkout with ASAP and time slots

Checkout showing field errors for name and phone

Order ticket FK-0001 with pickup time and LOCAL DEMO stamp

Install

From the ZIP to a simulator

The app is a native Expo project built with expo run; it does not run in Expo Go or in a browser.

Requirements

Node.js 20.19 or newer (verified with 24.21)
iOS: macOS with Xcode 27 and an iOS Simulator
Android: Android SDK 36, JDK 17, an emulator or device

Rebrand in four files

src/config/brand.json — name, scheme, bundle IDs, colours
src/config/restaurant.ts — time zone, hours, pickup rules, tax
src/data/menu.ts — dishes, modifiers, allergens
assets/brand/ — icon and splash (SVG sources included)

cd mealvoro/mobile
npm ci
npm run check          # types, lint, 77 tests
npx expo run:ios       # iOS Simulator
npx expo run:android   # Android emulator

# release-like builds
npx expo run:ios --configuration Release
npx expo run:android --variant release

# optional end-to-end journeys
maestro test e2e/

Honest scope

Included, needs your backend, not included

Works on the device

Menu search, diet filters, allergen hiding, favourites
Modifier rules, quantities, kitchen notes
Docket totals in integer cents, tax rounded once
Opening hours in the kitchen's time zone
Pickup slots: lead time, windows, capacity
Order history, reorder, cancel, share
Persistence, reset, JSON export, light and dark

Local demo

Needs your backend

Sending orders to a kitchen or POS (typed gateway included)
Real slot availability (demo capacity is simulated)
Verified allergen and ingredient data

Not included

Payments and card forms
Accounts, sign-in, loyalty
Live order status, push notifications
Delivery, couriers, kitchen or admin apps
App Store or Play Store submission

Verification

What was tested, and where

Simulator and emulator results are not physical-device results; both are listed separately.

Check	Environment	Result
TypeScript, ESLint, 77 Jest unit and journey tests	Extracted buyer package, Node 24.21	Passed
Expo Doctor (SDK 57 dependency set)	Extracted buyer package	21/21 passed
iOS Release build and 3 Maestro journeys	iPhone 17 simulator, iOS 26.5, Xcode 27	3/3 passed
Light, dark and largest-accessibility-text captures; reduced-motion pickup journey	iPhone 17 simulator	16/16 captures, passed
Android release APK and 3 Maestro journeys	Android 16 emulator (API 36)	3/3 passed
Light, dark and 2× font captures; reduced-motion pickup journey	Android 16 emulator (API 36)	15/15 captures, passed
Signed Release build for a physical iPhone	iPhone 14 Plus, iOS 26.6.2	Built and code-signed
Journeys on physical phones	iPhone 14 Plus, Galaxy A24	Pending: phones must be connected and unlocked