How to use Bag Guy

Scan, save, earn, plan, and share.

Bag Guy is built so a shopper can understand the first move quickly: open the app, scan, and let Bag Guy match eligible deals and rewards.

1. Start on Home

Home shows your savings summary, Bag Points balance, Store Credit value, local deals, weekly offers, and shortcuts.

  • Use Scan to Save as the main action.
  • Open View Deals to browse offers.
  • Open Meal Plan to shop recipes by budget.

2. Use Scan

The Scan tab is the core Bag Guy flow.

  1. Show your Bag Guy Scan Code at checkout.
  2. Scan a product barcode to find matching offers.
  3. Scan a receipt to process eligible receipt rewards.
If the backend cannot be reached in local testing, Bag Guy should show a clear connection message instead of pretending the reward was confirmed.

3. Save deals

Deals are organized around real shopping categories: grocery, household, baby, health, local, weekly ads, and SNAP-friendly.

  • Tap Save Offer or Clip.
  • Check quantity, size, expiration, and retailer restrictions.
  • Medium and low confidence matches ask you to check eligibility.

4. Track rewards

Rewards shows Bag Points, estimated Store Credit, recent activity, progress, and redemption actions.

  • Receipt scans can add Bag Points after backend confirmation.
  • Duplicate receipt attempts use source IDs to avoid double counting.
  • Rewards can sync locally and reconcile with the backend.

5. Plan meals

The AI Meal Planner helps create recipes around your budget, family size, cook time, weekly ads, and coupon matches.

  • Choose Low Budget, Standard, Premium, or High-End.
  • Tap Shop This Recipe.
  • Add ingredients to your Shopping List.

6. Build a shopping list

Shopping List pulls together manual items, recipe ingredients, saved deals, and weekly ad matches.

  • Check off items as you shop.
  • Review estimated total and savings.
  • Use Scan at checkout when ready.

7. Share and earn

Shopper Share lets users share lists, recipes, coupons, weekly deals, SNAP-friendly baskets, and budget meal plans.

  • Share inside the app, by link, QR placeholder, text/share sheet placeholder, family group, or community feed.
  • Bag Points can be awarded when someone saves, shops, redeems, or joins through shared content.
  • Reward limits, duplicate detection, and no self-referral rules are planned into the backend architecture.

8. Use SNAP-friendly tools respectfully

SNAP-friendly areas show EBT eligible tags where known, family essentials, healthy rewards, and budget helper tools.

Final eligibility is determined at checkout by the retailer and payment processor.

Local testing checklist

  1. Start backend: venv/bin/python -m uvicorn main:app --host 0.0.0.0 --port 8000 --reload
  2. Find Mac LAN IP: ipconfig getifaddr en0
  3. On iPhone Safari, open http://MAC_LAN_IP:8000/health
  4. Start Expo: npx expo start -c --lan
  5. Open Expo Go, tap Scan Receipt, then check Rewards history.
A physical iPhone cannot use 127.0.0.1 to reach a backend running on your Mac. Use the Mac LAN IP.