RobOS Shopping Lists

RobOS Shopping Lists (packages/shopping-lists) is part of the RobOS Household & Personal Finance suite alongside RobOS Household and robos.tax. It comes pre-loaded with three store-tailored lists—Grocery, Target, and Costco—and lets you create additional lists whenever your household needs them.

Three ready-made household lists

Form-like item entry and per-row controls

Rather than editing plain bullet text by hand while carrying a basket, every list gives you form controls on both desktop and mobile:

• Structured Add Item form: enter an item name, adjust quantity with − / + buttons, pick a unit (ea, pack, lb, oz, gal, case, bag, box, bunch), let the store’s keyword rules auto-select the aisle (or choose one explicitly), add an optional unit price ($) or coupon note, and attach a highlight badge (🔥 Must Have, 🏷️ Sale / Coupon, 🌿 Organic, ⭐ Store Brand / Fav).
• 1-Tap Quick-Add staples: tap any frequent item pill to add it immediately—or increment its quantity if it is already on the list.
• Per-item row buttons: every item has a circular check-off button (updating the live cart progress ring and estimated remaining cost), inline − and + quantity steppers, an inline Edit dialog, and a Remove button backed by Undo and Clear Checked.
• Multi-store smart paste & optional AI: paste a recipe or comma-separated list (2 gal milk, 4 avocados, laundry pods at target, olive oil at costco) to route items to the right store offline; if an AI CLI is configured, the optional ✦ Parse with Active RobOS AI Agent button can also parse free-form notes through robos-lib/ai-agent.
• Household finance CSV export: Export Household CSV formats items, merchants, categories, quantities and line totals as CSV ready for reconciliation workflows.

Viewing and editing on mobile in Google Docs & Google Drive

RobOS Shopping Lists pairs native Google Docs viewing with interactive mobile form buttons in two complementary ways:

1. Native Google Docs in Google Drive (application/vnd.google-apps.document):
   • Sign in once through RobOS Cloud Accounts (or click Sign In inside the app) and click Sync All 3 Lists to Google Docs & Drive.
   • RobOS creates (or updates) a RobOS Household Shopping Lists folder in your Google Drive containing three native Google Docs—Grocery — RobOS Shopping List, Target — RobOS Shopping List, and Costco — RobOS Shopping List—plus shopping-lists.json.
   • Each Google Doc renders cleanly in the Google Docs and Google Drive iOS/Android mobile apps with store headers, remaining vs. in-cart counts, aisle headings, ☐ / ☑ checkboxes, notes, cross-links between lists, and a Share with Family option that grants Drive folder access to a partner or family member.
   • Two-way Google Docs pull: if you check off ☑ / [x] or type a new ☐ Item — 2 pack line directly inside the Google Docs mobile app, syncing with Pull mobile edits from Google Docs merges those changes back into RobOS.
2. Interactive Mobile Form (LAN QR + Serverless Google Drive Apps Script):
   • On home Wi-Fi or RobOS Private Networks, scan the built-in QR code to open the live mobile web companion (:19225), which syncs in real time via Server-Sent Events.
   • For cellular 5G inside the store when your home computer is off, RobOS generates and uploads Mobile-Form-Apps-Script/Code.gs and Index.html into your Google Drive folder. Deploying that script as a Google Apps Script Web App (script.google.com) embeds a Tap Here to Add / Remove Items (Mobile Form) link right at the top of each Google Doc, updating both shopping-lists.json and the Google Docs directly in Google Drive.

Where data lives

• Local state: ~/.config/robos/household/shopping-lists.json (honors ROBOS_CONFIG_DIR and syncs under config/household/** in Config Sync).
• Ports: mobile form & Google Doc preview HTTP server on :19225 (SHOPPING_LISTS_WEB_PORT), DOM snapshot debug server on :19224.
• Source: packages/shopping-lists. Tests live in packages/robos-test/tests/shopping-lists/.

Run from source

# Desktop Electron app
electron packages/shopping-lists --no-sandbox --disable-gpu --disable-dev-shm-usage

# Standalone mobile/web form server
node packages/shopping-lists/serve.js