Context
This is the umbrella tracker for shipping stacksjs/pet-store as our first real ecommerce storefront. Per Chris's 2026-05-06 7:49 AM Discord drop:
"https://github.com/stacksjs/pet-store - please help out to make this the first ecommerce store of ours (we make most our dogs treats and we're thinking about just selling them among the neighborhood and in town etc., and maybe some social marketing) -> mostly, this is just an early ecommerce store for us to develop to ensure it all works flawlessly, all our features, that it's properly configurable, etc."
Pet-store is two things at once:
- A real storefront for Chris's dehydrated (NOT freeze-dried) dog treats — 165% for 18-36 hours.
- The end-to-end shakedown of our ecommerce stack — every gap surfaced here is a bug to fix in
stacksjs/stacks(the framework), not a one-off patch in this repo.
Sub-tasks (tracked as separate issues, linked here)
Each surface gets its own issue once scoped. Initial slice:
- Catalog — product listing page + product detail page. Configurable taxonomies (categories, tags). Image handling via
ts-images. - Cart — add/remove/update quantity, persistence (logged-out + logged-in), price calculation incl. tax/shipping placeholders.
- Checkout — flow + payments provider integration (decide: Stripe? something else? — our framework should make this swappable). Address capture, order summary, confirmation page, confirmation email.
- Account — signup/login (consumes the Stacks auth surface; uncovers any gaps incl. stacks#1839 bearer token expiry), profile, address book, password reset.
- Orders — order history per account, single-order detail, status tracking, re-order action.
- Admin — minimal admin to add/edit products, view orders, mark fulfilled. Reuses the dashboard surface from
stacksjs/stacks(stacks#1838). - Email — order confirmation, shipping notification, password-reset templates.
- Configurability audit — nothing storefront-specific hardcoded in framework code; storefront-specific stuff lives in
pet-store's config; framework defaults sensible. - Copy review — all product/marketing copy correctly reflects "dehydrated at 165% for 18-36 hours". No stray "freeze-dried" anywhere.
- Social marketing surface — minimal share-friendly OG images per product, sitemap, structured data (Product schema) for SEO.
Working principle
Anything rough/missing/hardcoded that surfaces while building this storefront is a fix to land in the framework / our libs, not a patch here.
When you hit a gap, file an issue on the appropriate framework repo (most often stacksjs/stacks) and link it back to this umbrella. Don't paper over it locally.
Definition of done (for the umbrella)
- A real customer can land on the site, browse products, add to cart, check out as a guest or signed-in user, receive an order confirmation email, and the order shows up in admin.
- All copy is accurate (dehydrated, never freeze-dried).
- Storefront-specific config is in pet-store; framework defaults are reusable for the next store.
- No regressions to existing Stacks framework behavior.