Start with install notes or jump straight into the API.

Guides

hev-shop

What hev-shop is

hev-shop is a live semantic shopping app built on the Layer gateway. It turns Amazon Reviews 2023 product and review data into vectors, writes through Layer into Turbopuffer, and serves search, filters, product pages, and review-derived tags.

The running storefront is public so you can see what a Layer-backed workload looks like end to end. The source code is not currently open source — it ships as a reference starter kit granted to design-preview participants.

Live demo See the running semantic storefront. Design preview How to get source access and start building on the reference architecture.

Reference starter kit

Design-preview participants get private repo access and fork hev-shop as the starting point for their own workload. The pieces worth knowing before you fork:

  • indexer/app/layer_client.py — single HTTP path to the Layer gateway.
  • indexer/app/pipeline.py — claim, heartbeat, stage, and completion lifecycle.
  • web/app/api/search/route.ts and web/lib/backend.ts — search through the backend with stable_as_of preserved.
  • helm/hev-shop — pipeline-metric scaling and optional CPU/GPU node pools.

Why it matters

The repo is not a generic ecommerce starter. It makes the application contract concrete: stage work, claim work, embed it, write vectors, query with freshness signals, and let the gateway own the Turbopuffer edge — so your team starts from a working pattern, not a blank slate.