Grocery Price Compare is a web application that lets a shopper compare grocery prices at stores near them. The product intent is narrow and concrete: a shopper enters a grocery item, and the app shows what each nearby store charges for that item so the shopper can decide where to buy. The audience is everyday household shoppers in the United States who want a warm, honest, legible view of local grocery pricing rather than a technical price-tracking tool.
The experience is delivered as a first-party React web application backed by a shared FastAPI service and a MariaDB database. The public entry page introduces the product and carries the search that starts a comparison; the Compare page is where the shopper searches an item and reads nearby store prices. No account is required to use either page.
Grocery Price Compare is a single-purpose comparison tool. Its whole job is to take one grocery item from the shopper and return the prices that nearby stores charge for it, presented so the shopper can pick where to buy. The product does not attempt to be a shopping list, a coupon manager, a loyalty program, a delivery service, or a store inventory system.
Delivery is first-party and headless-free: the application owns both the public entry and the comparison experience. The Landing page is the public entry surface that explains the product and hosts the search that begins a comparison. The Compare page is the working surface where the shopper enters a grocery item and sees prices from nearby stores. Both pages are reachable without an account; the accepted journeys do not require durable shopper-specific state, so no sign-in, registration, or profile is part of the current product.
The shared FastAPI backend owns the application APIs and domain logic for item search and nearby-store price lookup. MariaDB holds application-owned persistent data used to serve those lookups. The React frontend renders both pages and calls the backend. Location context ("near me") is used to scope which stores are considered nearby; the product presents nearby store prices for the searched item.
Everything described here is current. No future-horizon features are committed in this document.
FR-1 — Compare grocery prices at nearby stores (explicit) As a Shopper, I should compare grocery prices at stores near me, so that I can decide where to buy.
FR-2 — Search for a grocery item to compare (explicit) As a Shopper, I should search for a grocery item, so that the app can find prices for that specific item.
FR-3 — See prices from nearby stores for a grocery item (explicit) As a Shopper, I should see prices from nearby stores for a grocery item, so that I can compare what each store charges.
FR-4 — Enter a grocery item to start the comparison (required_inference) As a Shopper, I should enter a grocery item to start the comparison, so that the app has the item it needs to look up nearby prices.
The visual system follows the supplied creative direction: warm modernism inspired by Charles & Ray Eames — order with joy, friendly price data for family shoppers, never technical.
#F4EDE1 (cream ground, ~60% of the surface)#FBF7EF (panels and cards)#24211C (walnut ink)#1F5C55 (teal, for controls)#D2542B (tomato red, marks the lowest price and the hero button)#8A7F6D (secondary text and hairlines support)#D9A441 (mustard, for tags and the hero block)The public entry is a split hero built from the direction's hero move. On the left, a tall solid mustard (#D9A441) block bleeds off the left edge and holds the oversized Jost headline "Compare grocery prices near you" in walnut ink (#24211C), sized with clamp() from 40px on mobile to 96px on desktop so it stays whole at 375px, 768px, and 1280px. On the right, a full-bleed warm still-life photograph of groceries on a plain ground. Directly under the headline sits a cream (#FBF7EF) search bar with a tomato-red (#D2542B) "Compare prices" button. A thin full-viewport mustard rule closes the hero and marks the transition into the product explanation below. The gesture of the mustard block bleeding off the edge is carried by the colour block and imagery only — the headline, subline, and controls remain fully inside the viewport and their containers at every breakpoint.
Interaction Model: Animated Motion Tempo: restrained Hero Dimensionality: layered_2d
Landing Hero Motion Brief
prefers-reduced-motion, the hero renders as a static arrangement — photograph and mustard block in place, headline, subline, and search controls fully visible and usable, no pan or fade.font-size: clamp(...)) to fit; no element covers any readable text or control. Imagery and decoration may bleed, crop, or overlap as the direction asks, provided they cover no readable text or control.prefers-reduced-motion, a usable static arrangement is provided; any moving or scrollable content wraps or scrolls so each item can be brought fully into view.
Grocery Price Compare
Search one item and see what each nearby store charges today.
Prices come from stores near you for the item you enter.
What this is
Grocery Price Compare does one job well: you type a grocery item, and we show what each nearby store charges for it today. No lists to manage, no accounts to create — just the item you came for and the prices around you.
Prices are laid out as plain rows, one store to a line, with the lowest price stamped so you can spot it at a glance and decide where to do your shopping.

Grocery Price Compare
Search one item and see what each nearby store charges today.
Prices come from stores near you for the item you enter.
What this is
Grocery Price Compare does one job well: you type a grocery item, and we show what each nearby store charges for it today. No lists to manage, no accounts to create — just the item you came for and the prices around you.
Prices are laid out as plain rows, one store to a line, with the lowest price stamped so you can spot it at a glance and decide where to do your shopping.
No comments yet. Be the first!