Mongoose Doc Alignment

Replace ALL instances of 'Melisa' or 'Melissa'...

Replace ALL instances of 'Melisa' or 'Melissa' with 'Lerato'...

| Dev Sprint 2 | Critical and High-severity gap fixes (delete and edit inventory items, budget navigation, etc.) | Focus: CRITICAL and HIGH issues, parallel work on criticals |

Dev Sprint 3 | Receipt scanning (Google Cloud Vision)

Anticipate updates related to Sprint 3: 'Receipt scanning using Google Cloud Vision'.

demo@pantry-test.invalid

demo@pantry-validate.invalid

Lerato/Thabo/Grace personas

Latest version of Lerato/Thabo/Grace personas

Same architectural pattern as our canister/liquid sensor setup.

Aligns with the latest sensor implementation strategies.

No em dashes anywhere.

Ensure no em dashes are used in any code, comments, strings, or documentation as per the Audit Fix Sprint rules.

stop using HSL. Use OKLCH.

Use OKLCH color functions for uniform palettes, per current best practices.

Every interactive element needs these states.

Consider including app-specific interactions, such as long-press and swipe, per current implementation details.

Animation should not be used to hide slow loading.

Update to include recommended motion practices for new UI elements from the Audit Fix Sprint.

## Spacing Systems

## Spacing Systems

### Pantry App Specifics
Include guidelines on how Pantry implements spacing principles.

## Classic Typography Principles

## Classic Typography Principles

### Pantry Typography
Include guidance on how these principles apply in Pantry.

## Polish Systematically

## Polish Systematically

### Pantry App Focus Areas
Target areas needing attention based on past bug density or UX reviews.

Perform comprehensive audit of interface quality across accessibility, performance, theming, and responsive design. Generates detailed report...

Audit interface quality including accessibility, performance, theming, responsive design, and anti-patterns. Generate prioritized issue reports with actionable recommendations.

AI slop tells (AI color palette, gradient text, glassmorphism, hero metrics, card grids, generic fonts...

AI slop tells (AI color palette, gradient text, glassmorphism, hero metrics, card grids, generic fonts) and new AI-generated design traits, like repetitive iconography.

Use the frontend-design skill — it contains design principles, anti-patterns, and the **Context Gathering Protocol**.

Follow updated design protocols as outlined in CLAUDE.md.

--accent:       #22D3EE;

--accent:       #00ACC1;

MONGOOSE DESIGN SYSTEM — do not edit manually

KITCHEN TABLE DESIGN SYSTEM — follow latest tokens

--pink:       #DB2777;

--pink:       #F472B6;

<!-- Placeholder for recent audit details -->

<p>Recent navigation updates include the Budget page and other critical route fixes.</p>

<!-- Add new features here -->

<!-- Add new features here -->
<section><h2>CRITICAL-001: Delete Inventory Item</h2><p>No way to remove an item from inventory...</p></section>
<section><h2>CRITICAL-002: Edit Inventory Item</h2><p>Users can only increment/decrement...</p></section>
<section><h2>CRITICAL-003: Budget not in Main Nav</h2><p>Budget page exists at /budget but is not in...</p></section>
<section><h2>HIGH-001: Wire Dashboard Action Buttons</h2><p>Dashboard has action buttons (Quick Add...</p></section>
<section><h2>HI

<span class="tag tag-status-done">Done</span>

<span class="tag tag-status-inprogress">In Progress</span>

<p>BarcodeScan.jsx handles the scanning flow and relies on OFF lookup only.</p>

<p>BarcodeScan.jsx now includes price enrichment from Woolworths after scanning.</p>

<!-- Deployment procedures -->

<!-- Deployment procedures -->
<section><h2>Cloudflare Deployment</h2><p>Deploy using CLOUDFLARE_API_TOKEN...</p><p>Verify on pantry-app.tapfumamv.com...</p></section>

</body>

<section class="category-block"><div class="category-header"><div class="category-dot"></div><div class="category-label">Sprint Decisions</div></div><div class="decision-card"><div class="decision-card-top"><div class="dec-id">CRITICAL-001</div><div class="dec-main"><div class="dec-title">Delete Inventory Item</div><div class="dec-summary">Long-press on item to delete with confirmation dialog.</div></div><div class="dec-meta"><div class="dec-date">04/01/2026</div><div class="dec-status status-co

<h2>Content sections</h2>

<h2>Audit Fix Sprint Highlights</h2><ul><li>Critical Fix: Deletion of Inventory Item implemented.</li><li>Critical Fix: Editing of Inventory Item enabled.</li><li>High Priority: Dashboard wiring completed.</li><li>High Priority: Recipe deletion implemented.</li><li>404 Page and navigation updates.</li></ul><h2>Content sections</h2>

<!-- End of header-meta -->

<span class="badge badge-report">Dashboard wiring completed</span><span class="badge badge-report">Integration tests for inventory operations added</span><!-- End of header-meta -->

<!-- Summary stats row -->

<div class="summary-stats"><div class="summary-stat"><span class="num">7</span><span class="label">Issues Addressed</span></div><div class="summary-stat"><span class="num">6</span><span class="label">PO Confirms</span></div><div class="summary-stat"><span class="num">1</span><span class="label">Stakeholder Feedback Incorporated</span></div></div><!-- Summary stats row -->

N/A

<!-- Add information regarding the recent sprints: CRITICAL and HIGH issues fixed, and new capabilities introduced. -->

<div class="tl-dot done"></div>

<div class="tl-dot next"></div>

N/A

<!-- Update: Reflect changes like Price Enrichment, Woolworths Product Search integration, and any responsive adjustments. -->

N/A

<!-- Mind map needs updating to include connection between features like new recipe deletion and navigational enhancements. -->

| Dev Sprint 3 | Receipt scanning | Complete |

| Dev Sprint 3 | Receipt scanning | Not started |

- **App:** pantry-app.tapfumamv.com (live, Sprint 4 complete)

- **App:** pantry-app.tapfumamv.com (live, Audit Fix Sprint in progress)

<div class="feature-list">

<div class="feature-list"><div class="feature-row"><span class="feat-dot tag-gap"></span><div class="feat-body"><div class="feat-name">Audit Fix Sprint</div><div class="feat-desc">Fixes critical gaps in app functionality.</div></div></div><div class="feature-row"><span class="feat-dot tag-growth"></span><div class="feat-body"><div class="feat-name">Smart Capture + Price Sprint</div><div class="feat-desc">Enhancements to product entry with Woolworths integration.</div></div></div>

<div class="feat-desc">Navigation update: XYZ</div>

<div class="feat-desc">Navigation update: Budget added between Recipes and Scan.</div>

<div class="seq-title">Inventory Item Management</div>

<div class="seq-title">Inventory Item Management - Updated for Inline Deletion and Confirmation</div>

<svg></svg>

<svg><!-- Sequence diagram depicting recipe deletion --></svg>

<!-- Placeholder for medium priority task details -->

DevOps Engineer applies index migration to live Supabase using `supabase db push`.

<p>Task details with inconsistent formatting</p>

<p>Corrected task details with consistent formatting.</p>

<h2>Completed Work</h2>

<h2>Completed Work</h2><p>CRITICAL-001: Delete inventory item, implemented with long-press reveal and confirmation dialog.</p><p>CRITICAL-002: Full edit of inventory item facilitated through a modal...</p>

<p>Main navigation tasks were completed.</p>

<p>Main navigation tasks were completed, including the addition of 'Budget' to the main navigation.</p>

<h2>Planned Features</h2><p>Focus on Smart Capture and Price Enrichment.</p>

<h2>Planned Features</h2><p>Focus on Smart Capture, Price Enrichment, Woolworths Product Search Page, and Photo Product Identification.</p>

<p>Budget page exists at `/budget` but is not in the main navigation.</p>

<p>Budget page is now in the main navigation.</p>

<p>Unknown routes show a blank page. Should show a helpful not-found screen.</p>

<p>Unknown routes now show a helpful not-found screen.</p>

<!-- Add MEDIUM-001 entry here -->

<p>The missing DB indexes have been created to improve performance on frequently queried columns.</p>

<p>No way to delete a recipe. Users are stuck with recipes they created.</p>

<p>Users can now delete recipes they created.</p>

<!-- SECTION_STATUS_END -->

<div class="section"><h2 class="section-title">Sprint Update</h2><div class="section-body"><p>The Pantry Audit Fix Sprint as of 2026-04-01 successfully resolved critical issues involving inventory management, navigation improvements, and recipe management. All tasks are completed, meeting the company's definition of done.</p></div></div><!-- SECTION_STATUS_END -->

<!-- USE_CASES_END -->

<div class="card"><div class="card-header"><span class="card-title">Smart Capture + Price Sprint</span><span class="card-meta">Added 2026-04-01</span></div><div class="card-body"><p>With the addition of real-time price enrichment and integrated product search, the pantry app facilitates better inventory management and shopping experience for users. This update allows users to view prices from Woolworths and pre-fill product information while scanning barcodes.</p></div></div><!-- USE_CASES_END -

Pilot: St Teresa's, 60 families - Offer school free hardware + subsidised kits for one term

Pilot: St Teresa's, engaging with 60+ families - Successfully conducted with provision of free hardware and subsidised kits.

Price comparison across delivery platforms before ordering

This item is pending Phase 2 implementation details.

GRY-004, GRY-005, and CAP-004 tasks involving Woolworths integration and photo identification.

Expiry date tracking + waste-reduction alerts (PF-003)

CRITICAL tasks: Delete and edit inventory item, and add Budget to main nav.

Include Woolworths integration and logic from spikes for GRY-004, GRY-005, and CAP-004.

Barcode scanning as alternative capture method (PF-001)

Barcode scan includes Woolworths price enrichment and search enhancements.

GRY-004 and GRY-005 use Woolworths API for price and product search integration.

Integration tests required for every auth/RLS story.

Integration tests required, including photo-based product ID for CAP-004.

OCR: Google Cloud Vision (Sprint 3)

OCR: Google Cloud Vision with current tasks — refer to audit fix sprint for details.

Build against live Supabase from day one.

Build against live Supabase with Woolworths API integration for better accuracy.

/* Define animations normally */
.card {
  animation: slide-up 500ms ease-out;
}

/* Define animations normally */
.card {
  animation: slide-up 500ms ease-out;
}
.long-press, .edit-sheet {
  animation-duration: 0.01ms !important;
}

Show recent searches...generate interest.

Show recent searches...generate interest.
:: It is important to ensure every newly introduced navigation such as /budget or /recipes is correctly handled in this structure to minimize the impact of broken links.

The common mistake...rabic.

The common mistake...rabic. With the recent update, including design elements from the Pantry sprint, use appropriate fonts suiting each page requirement.

Are there known issues to preserve (mark with TODOs)?

Are there known issues to preserve (mark with TODOs)? Is the UI responsive across different devices?

Discoverability & Affordance

Data Integrity Check: Ensure no placeholder content or hardcoded values are used.
Discoverability & Affordance

Accessibility (A11y) - Check for:

Integrity Checks: Ensure no placeholder values or hardcoded IDs are present.
Accessibility (A11y) - Check for:

Follow the protocol before proceeding — if no design context exists yet, you MUST run teach-impeccable first.

Follow 'CLAUDE.md' exactly before proceeding — refer to it strictly.

Follow the protocol before proceeding — if no design context exists yet, you MUST run teach-impeccable first.

Follow 'CLAUDE.md' exactly before proceeding — refer to it strictly.

Follow the protocol before proceeding — if no design context exists yet, you MUST run teach-impeccable first.

Follow 'CLAUDE.md' exactly before proceeding — refer to it strictly.

can invite or remove members, edit inventory, manage budgets, and delete records

can invite or remove members, manage inventory, and configure stock thresholds

Project uses React 19 with Vite 8

Project uses React 18 with Vite 8

Vite 8 project initialised with all dependencies

Vite 9 project initialised with all dependencies

| 1 | **GRY-002: Quick Add** | 1 | Quickest to ship (frontend only).

| 1 | **GRY-002: Quick Add** | 1 | Enhanced with step updates from latest doc.

N/A

Add a search/shop icon button to the Inventory page header to navigate to '/product-search'.

N/A

Create `src/pages/NotFound.jsx` to display a 'Page not found' message.

N/A

Update the document to include wiring details for dashboard buttons: e.g., /inventory/add, /inventory.

Date: 2026-03-31

Date: 2026-04-01

Status: Draft, pending contributions

Status: Updated with latest objectives

N/A

Include Budget in NAV_ITEMS: 'Budget' between Recipes and Scan with wallet or chart SVG.

N/A

Update to include flow for displaying a 404 page at routes that are not found.

N/A

Add database indexes for columns to optimize query performance: household_id, items, and others.

Date: 2026-03-31

Date: 2026-04-01

Author: UX Research

Author: UX Research, finalized by Team Lead

Done

Done

### Recipe Deletion
- Located on recipe detail page (`/recipes/:id`).
- Includes confirmation dialog: 'Delete [Recipe name]? This cannot be undone.'

## Persona Walk-through

- [ ] Budget can be accessed from main navigation bar

## Persona Walk-through

No broken states: loading, empty, error all handled

Loading, empty, error, and 404 states all handled

For each data entity created or modified this sprint, confirm each operation is implemented or explicitly deferred with a backlog ticket:

For each data entity created or modified this sprint (including Budget), confirm each operation is implemented or explicitly deferred with a backlog ticket:

Integration test in `src/test/integration.test.js` covers the story

Integration test in `src/test/integration.test.js` covers the story, including recipe and inventory item deletions.

**Acceptance Criteria:**

**Acceptance Criteria:**
- [ ] AC-18: Budget can be accessed directly from the main navigation.

Loading and error states present on every section (summary, receipts list)

Loading, error, and 404 states present on every section (summary, receipts list)

N/A

### Main Navigation Update
- Add Budget to the navigation as a main item, following the implementation details specified in the source document.

lerato@pantry-test.invalid

lerato@pantry-app.invalid

Stock now button [...] operation (insert into inventory)

Stock now button triggers the following operations: 1. Insert into inventory. 2. Update last_stocked_at. 3. Recalculate next_due_date.

ambient highlight

highlight

These rules are non-negotiable.

Read CLAUDE.md in the project root before doing anything else. These rules are non-negotiable.

*Last updated: 2026-03-20 (Sprint 1 retro)*

*Last updated: 2026-04-01 (Sprint 2 planning)*

Trundler covers Makro via paid plan

Trundler could provide price comparison across retailers; requires budget approval.

Required for production storage (microSD = temp)

NVMe SSD 256GB M.2 2230 is outstanding for production storage.

**Status:** Complete — deployed to pantry-app.tapfumamv.com

**Status:** In progress with additional audit fix tasks

- Woolworths price lookup integrated with barcode scanning
- Price badge shown in FOUND and NEW_ITEM states

The device torch activates and illuminates the area in front of the camera.

The device torch activates or indicates unsupported if torch control is not available.

Story 4 > Story 2 > Story 3 > Smoke Test

Story 4 > Story 2 > Story 3 > Smoke Test > Continue Audit Fix Tasks

Pantry is available now at pantry-app.tapfumamv.com.

Visit pantry-app.tapfumamv.com for the latest features including international expansion and mobile alerts.

WhatsApp agent — unclear if existing bot or expected feature

WhatsApp agent — expected feature to complement existing manual input methods

Sprint 4 Report | /sprint-4-report.html | 2026-03-20

Barcode Sprint | Sprint Complete, and Smart Capture + Price Sprint | In Progress

app.tapfumamv.com (live, Audit Fix Sprint complete)

app.tapfumamv.com (live, Smart Capture + Price Sprint in progress)