Skip to content

Add dw-demo-headless skill: Next.js storefront + DW10 Delivery API demos#40

Merged
Justinvolved merged 1 commit into
v2from
fold/headless-storefront
Jul 3, 2026
Merged

Add dw-demo-headless skill: Next.js storefront + DW10 Delivery API demos#40
Justinvolved merged 1 commit into
v2from
fold/headless-storefront

Conversation

@Justinvolved

Copy link
Copy Markdown
Collaborator

New flow skill dw-demo-headless (presales cluster, Use AFTER dw-demo-base) covering the headless demo consumer: a vercel/commerce-based Next.js storefront driven by the DW10 Delivery API over a dedicated, presentation-agnostic serialized baseline that is its own product line, fully decoupled from Swift.

References:

  • headless-backend.md — Delivery API surface + two-token trap + language/ShopId locale gotcha + PLP repository/named-query requirement + item-type-XML-at-startup
  • headless-frontend.md — provider-module data-layer swap, DW_* env, self-signed-TLS dev bypass, build-time RSC fetch caveat, slug conventions
  • headless-baseline.md — presentation-agnostic item-type layer, id floor bands, EN/NL sibling-area parity, disk-overlay staging before host start, Full index build

Registered in marketplace.json + manifest.json; wired into dw-demo-base routing; bumped 3.9.0; validator clean (0 errors / 0 warnings). Routes to dw-headless-delivery for the raw endpoint catalog. Rebased onto v2 after #39 merged.

New flow skill in the presales cluster, sister to dw-demo-swift and
"Use AFTER dw-demo-base", covering the headless demo consumer: a
vercel/commerce-based Next.js storefront driven by the DW10 Delivery API
(/dwapi/**) over a dedicated, presentation-agnostic serialized baseline
that is its own product line, fully decoupled from Swift.

Three references:
- headless-backend.md: Delivery API surface map + auth model, the
  two-token trap (admin token 401s on /dwapi; frontend JWT via
  POST /dwapi/users/authenticate), the ENU-not-LANG1 locale gotcha, the
  PLP repository+named-query requirement (GET /products/search; POST
  /products 400s; count at totalProductsCount, facets at
  facetGroups[i].facets[j]), item-type-XML-at-startup fact.
- headless-frontend.md: provider-module data-layer swap, DW_* env wiring,
  self-signed-TLS dev bypass, build-time RSC fetch caveat, slug
  conventions, @vercel/* self-host disposition.
- headless-baseline.md: Headless_* item-type layer, 200000-209999 id
  floor band, EN/NL sibling-area parity, disk-overlay staging of
  itemtypes/+repositories/ before host start, Full index build after
  deserialize.

Register in marketplace.json (dynamicweb-presales) + regenerate
manifest.json; wire the headless demo path into dw-demo-base routing;
bump 3.9.0. Routes to dw-headless-delivery for the raw endpoint catalog.
@Justinvolved Justinvolved force-pushed the fold/headless-storefront branch from 63affa4 to 4396778 Compare July 3, 2026 10:31
@Justinvolved Justinvolved merged commit 3750e9a into v2 Jul 3, 2026
@Justinvolved Justinvolved deleted the fold/headless-storefront branch July 3, 2026 17:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant