# Changelog

## [0.4.0] — 2026-07-14

### Added
- **Customer returns** — on a delivered order, tap Return, pick a line item, attach a photo + reason, and submit to Baskit Ops.
- **Ops Returns inbox** (sibling `baskit_ops`) — new `returns` table, admin list/detail with approve/reject, and `POST/GET /api/v1/returns`.

## [0.3.1] — 2026-07-09

### Changed
- **My Baskit** basket screen aligned to design: home header, MY BASKIT title, image/qty column, retailer price arrows, BEST PRICE tags, saved/missed savings, OPTIMISE MY BASKIT, yellow CHECKOUT; nested in tab shell for bottom nav.
- **BasketModel** — cycle retailer per line via price arrows.

## [0.3.0] — 2026-07-09

### Changed
- **Group Buy join deal** screen aligned to design: header, Playfair title, itemised description, hero image, Members progress pill, original vs group price compare, qty pill + lime Join Deal.
- **Group Buy deals feed** (post-intro): home header, XXL Savings promo carousel, deal tiles with Playfair title, teaser, lime VIEW DEAL pill, and hero product image on white card.

## [0.2.9] — 2026-07-09

### Changed
- **Product detail** aligned to design: home header, best-buy retailer row, white hero card, Playfair price/name, green qty pill + lime ADD TO BASKIT, related categories; stays inside tab shell (bottom bar visible).

## [0.2.8] — 2026-07-09

### Changed
- **Category screens** match Meat & Poultry design: home-style header, subcategory horizontal strips (Previous Orders, Beef, Chicken), white product cards, scroll hint, related category tiles.
- **Search** groups results into aisle subcategory strips when matches span categories.

## [0.2.7] — 2026-07-09

### Changed
- **Category logos** replaced with official design art (Bakery, Dairy & Eggs, Fresh, Meat & Poultry, Home Essentials, VAS/Airtime).
- **Inverted variants** (`cat-*-inv.png`) generated for home tiles and related-aisle strips; standard cream-bg art used on Shop list.

## [0.2.6] — 2026-07-09

### Changed
- **Home screen** aligned to design reference: white background, underlined uppercase address, weekly savings line (lime **R** amount), deal carousel with on-banner pagination dots, 2×2 dark-green category tiles with cream icons, “Scroll down for more” hint, dark-green bottom nav icons.

## [0.2.5] — 2026-07-09

### Changed
- **Welcome back** screen (post-splash): centred serif greeting, “With Baskit you've since saved”, lime savings hero — auto-advances to home after 2.5s (no button).

## [0.2.4] — 2026-07-09

### Changed
- **Splash screen** uses the real app logo with inverted colours: green `#274101` background + cream `#F9F8CD` **B** mark (sampled from `app-icon.png`).

## [0.2.3] — 2026-07-09

### Added
- **App launcher icon** from official Baskit logo (`assets/app-icon.png`) on Android, iOS, and web via `flutter_launcher_icons`.

## [0.2.2] — 2026-07-09

### Added
- **PayFast sandbox checkout** (`/checkout/payfast`) — fake merchant login, demo credentials, places order with payment ref.
- **Last shop strip** on Home and Profile — quick basket preview of last paid order.
- **Order detail** (`/orders/:id`) — basket-style line list with **Copy** / **Make a new list copy** → rebuilds basket.
- **Order history** — persisted locally; reorder buttons on every past order.
- **Picker app (demo)** — `/picker` sign-in (`sipho@baskit.co.za`), job feed, accept, aisle pick, substitute sheet, bag/handoff code.

### Changed
- Checkout **Pay & place order** now routes through PayFast before order success.
- Demo seed order `BK-2841` shown when no order history exists.

## [0.2.1] — 2026-07-09

### Added
- **Order history** screen (`/orders`) with past order cards and track link.
- **Delivery address** editor (`/delivery-address`) wired from profile and header “Deliver here”.
- **Delivery slot picker** (`/checkout/slots`) returns selected window to checkout.
- **Help & support** FAQ screen (`/help`).

### Changed
- **Category listing:** 3-column compact grid, BUY AGAIN row, meat subsections (Beef/Chicken), related aisle chips.
- **Search:** Cancel button, popular search chips, “N RESULTS · CHEAPEST FIRST” header, quick-add rows.
- **Product detail:** share + basket top bar, SAVE tag on hero, category label, was-price strikethrough, related aisles, bordered qty stepper.

## [0.2.0] — 2026-07-09

### Added
- **Auth (local stub):** sign in, register (2-step), address verification with delivery-zone UI.
- **My Baskit redesign:** per-item cards, “cheaper elsewhere” tags, optimise banner, checkout CTA.
- **Smart Split:** cross-store optimisation screen with apply + checkout.
- **Checkout flow (demo):** delivery scheduling UI, pay stub, savings payoff, multi-retailer order tracking.
- **Group Buy tab:** intro, live deals list, deal detail, join + celebration, adds to basket.
- **Profile tab:** lifetime savings, delivery address, active order link, sign in/out.
- Unit test for Smart Split savings logic.

## [0.1.0] — 2026-07-08

### Added
- Thin PHP catalogue API (`api/`) over Dokploy MySQL with API key + per-IP rate limit.
- Flutter customer browsing MVP: splash, intro, welcome-back, home, shop aisles, category grid, search, product detail (cross-store compare), local basket.
- Baskit theme tokens and shared widgets (tags, retailer chips, aisle icons).
- Docs: `docs/index.md`, `docs/tasks/TASK-001.md`, `docs/NewKnowledgeBase.md`, `docs/scope_browsing_mvp.html`.