Repository navigation
Release v0.2.0
Pre-release
Pre-release
Release v0.2.0: Shopper storefront
First customer-complete storefront cut after the v0.1.0 foundation. Shoppers can register and sign in, browse the catalog, manage a cart, checkout against the mock payment adapter, poll order confirmation, and manage orders and addresses.
Targets ecommerce-store-api v0.8.0. Live Stripe and hosted staging are still out of scope. Playwright e2e still needs a live API; npm run dev:mock is the offline MSW preview.
Scope
| In this release | Not in this release |
|---|---|
| Auth, silent refresh, forced password change | Live Stripe Elements / real card capture |
| Catalog list/detail, filters, categories, SEO | Guest cart |
| Authenticated cart and checkout with order polling | Command palette / View Transitions |
| Orders history, account profile, address book | Hosted staging |
MSW dev:mock, release gate docs, visual showcase |
Shopper WebSocket feed |
| First-purchase empty states; Actions SHA pins; CONTRIBUTING / CoC / SECURITY |
Auth and session
- Login, register, in-memory access token, HttpOnly refresh cookie.
- Proactive / single-flight silent refresh.
- Forced password change for seeded customers (
mustChangePassword). - Customer chrome and route guards.
Catalog and SEO
- RSC catalog list and product detail against OpenAPI-typed client.
- Category pills, search, price bounds, sort; URL-driven filters.
- Declarative SEO foundation for catalog routes.
Cart and checkout
- Authenticated cart (
GET /v1/carts/current; 404 -> empty). - Checkout form with idempotency key and
?orderId=polling confirmation. - Pricing aligned with API money / shipping fields.
- Shared empty cart copy between cart and checkout.
Orders and account
- Own-order list and detail; filter-aware empty vs first-purchase empty.
GET /v1/users/meprofile and address book with shared empty shell.
Quality, preview, and docs
- Full shopper journey and a11y sweep; CI Playwright policy.
- Architecture boundary hardening and shopper contract consumption.
- MSW standalone preview (
npm run dev:mock). - Release gate runbook and visual showcase assets in README.
- Richer empty states / first-purchase guidance (catalog, cart, checkout, orders, addresses).
- GitHub Actions pinned to full commit SHAs; CONTRIBUTING, CODE_OF_CONDUCT, SECURITY reporting aligned with the API.
Stats
| Metric | Value |
|---|---|
| Since | v0.1.0 |
| Files changed | 342 |
| Insertions / deletions | +24,959 / -1,063 |
| Commits | 226 (209 excluding merges) |
Pull requests
| PR | Title |
|---|---|
| #31 | Empty states and repository hygiene |
| #29 | Visual showcase and hero media |
| #27 | Pricing alignment, MSW preview, and release docs |
| #26 | Harden architecture boundaries and shopper contracts |
| #25 | Quality sweep, e2e journey, and accessibility |
| #24 | Customer order history and account management |
| #20 | Checkout flow and order polling |
| #19 | Shopping cart and summary UI |
| #18 | Declarative SEO foundation |
| #17 | Catalog filtering and product detail |
| #16 | Forced password rotation and route guards |
| #15 | Authentication and proactive session refresh |
| #14 | Storefront shell, theme, and status diagnostics |
Full changelog: v0.1.0...v0.2.0