Welcome to SIPP, the all-in-one app for finding cafés, earning visit perks, and managing in-store orders. This guide walks both consumers and shop owners through every major workflow so you can get productive without additional training.
1. Getting Started
1.1 Install & Configure
Download the SIPP app from TestFlight or the App Store.
On first launch you’ll be prompted for:
Location access (needed for the map and nearby cafés).
Camera access (needed for scanning QR codes / visit redemptions).
Copy the provided configuration template if running a local build:
Fill in Supabase, StoreKit, and feature flag values (keep actual keys private).
1.2 Creating an Account
Tap Sign Up and choose your role from the segmented control:
Consumer: everyday guests discovering cafés and placing orders.
Shop Owner: café owners/managers running the queue and dashboard.
Enter your email + password, agree to terms, and tap Sign Up.
For existing accounts, choose Sign In; use Forgot password? for resets.
The app remembers your last role. Switch roles anytime from Profile → Role.
2. Consumer Experience
2.1 Home Map & Search
The landing tab is an interactive map showing nearby cafés. Pinch/drag to explore.
Use the search bar to type a city, café, or keyword; tap Search to refresh results.
The “Near Me” quick action recenters on your GPS location.
Tap a map pin to view quick details or open the full Cafe Detail sheet.
2.2 Quick Actions
Cart: Opens your current cart (if it has items). If empty, you’ll be prompted to add menu items first.
Near Me: Snaps the map to your current coordinates.
Scan: Launches the QR scanner to redeem visits or check in at partner cafés.
2.3 Cafe Detail
Shows status (open/closed), distance, address, hours, contact options, and a mini-map.
Buttons:
Directions opens Apple Maps.
Order Now slides up the in-app ordering experience.
2.4 Ordering & Customization
After tapping Order Now, browse menu sections with a vertical list. Pull down to refresh.
Tap an item to customize:
Choose variants (size/roast).
Toggle modifiers and options. Mandatory options must be selected before adding to cart.
Add notes (e.g., “oat milk”).
Tap Add to Cart to save the item. The cart persists between sessions for that café.
2.5 Cart & Checkout
Tap the cart icon (top-right) inside Ordering or use the Cart quick action from Home.
Within the cart:
Update quantity via the stepper.
Remove items with the trash icon.
Set a tip amount using the preset buttons or custom entry.
Add a pickup note or promo code when available.
Use Checkout to sync the cart with the backend. Follow on-screen prompts to complete payment (StoreKit or in-app instructions depending on release stage).
Use Clear cart to reset your order; you’ll be asked to confirm.
2.6 Orders & Activity
The Activity tab logs past orders, visits, and subscription perks.
Scroll for older entries; pull to refresh.
Tap an order for full details when implemented; otherwise review the summary card.
2.7 QR Scanning & Visits
Use the Scan quick action or the QR tab in Activity (if enabled).
Align the café’s QR code; you’ll see a success toast and the Activity tab will gain a badge.
2.8 Subscriptions & Rewards
Navigate to Profile → Subscription to view current plan, remaining visits, and upgrade options.
Two purchase paths are available:
Subscribe with Apple – Uses StoreKit; stay signed into the same Apple ID across devices so the subscription syncs automatically.
Pay with Card – Opens Stripe’s hosted Checkout in an in-app Safari sheet. When the payment succeeds you’ll be redirected to the success URL and the app refreshes your visit balance automatically. If you cancel or close the sheet, no charge occurs and you remain on the current plan.
After either flow completes, the Membership screen refreshes your balance and the Activity tab reflects the upgraded quota.
Use Manage billing on this screen at any time to open the Stripe Billing Portal (web) for card updates, plan changes, or cancellations.
If the banner “You’re offline” appears, reconnect to the internet; most actions queue or gracefully fail.
For stuck carts, tap Clear cart and retry adding items.
Sign out/in if the app fails to refresh tokens. This also wipes cached cart data.
3. Shop Experience
3.1 Entering Shop Mode
Sign in with a Shop account or switch roles via Profile → Role → Shop Owner.
The app loads ShopRootView, a dashboard with four tabs: Dashboard, Queue, QR, Settings.
If you own multiple cafés, use the banner at the top to switch between them.
3.2 Dashboard
Provides sales summaries, visit stats, and top items (data depends on backend availability).
Pull down to refresh; tap cards for more detail where supported.
3.3 Order Queue
Shows New, In Progress, and Completed sections.
Tap an order to view line items and customer notes.
Actions typically include:
Accept / Start to begin preparing.
Ready or Complete when finished.
Cancel with a confirmation dialog for edge cases.
Badges on the tab show pending orders; they clear as you complete items.
3.4 QR Display
Presents a persistent QR code for in-store scanners or consumer check-ins.
Keep brightness high on iPads or dedicated devices to improve scan reliability.
3.5 Shop Settings
Manage café details (name, hours, address), toggle active status, and update branding colors where available.
Configure staff roles: invite via email, remove users, and regenerate codes.
Access the Manage Cafés sheet from the top banner for onboarding new spots or editing existing ones.
3.6 Staff & Team Management
Inside ShopOnboardingView:
Create a café with address + geolocation + menu template.
Edit menu templates or toggle “Active” status for temporary closures.
Handle staff invites/removals.
3.7 Cross-Role Workflows
To test end-to-end:
Use a consumer account to place an order.
Switch to the shop account tied to that café and open the queue.
Accept and complete the order; verify the consumer’s Activity tab updates after refresh.
For visit redemptions, have a consumer scan the QR generated in the shop app.
3.8 Managing Sessions
If Missing Shop Session appears, select a café from the top banner.
Logging out clears cached shop data; log back in and reselect an active café to restore context.
4. Tips & Best Practices
Keep Config files out of git: real keys go only in your local .xcconfig.
Use iCloud Keychain to autofill complex passwords; SIPP respects textContentType settings.
Background sync: Cart changes sync automatically after edits; avoid force-quitting during checkout.
Accessibility: Increase Dynamic Type in iOS settings—most screens adapt automatically.
Support: If something looks wrong, capture logs via Xcode (Devices console) or grab screenshots when filing tickets.
5. FAQs
Q: Can I use the same email for both roles?
Yes. Sign in once, then switch roles from the Profile tab; your cart/session data stays separate per role context.
Q: Why is my cart empty after switching cafés?
Cart contents are scoped per café. Starting an order at a new café clears the previous cart to avoid mixing menus.
Q: How do I add another café to my shop account?
In Shop mode, open the top banner → Manage cafés. Use the + button in Shop Onboarding to add a new location.
Q: Checkout fails with “Unable to open cart.” What now?
This means the app can’t fetch the café metadata attached to your cart. Close the sheet, reopen the menu, and try again; if it persists, clear the cart.
Q: How do staff access the queue without owner rights?
Invite them via Manage Team inside Shop Onboarding. Staff accounts see the same Shop tabs but may be limited in Settings depending on backend roles.
Need more help? Reach out through your team’s support channel or file an issue with screenshots, reproduction steps, and logs. Enjoy your next sip!