Liquid Implementation handoff
Run 2026-05-11-stage-5b-natural-harmony-pdp · Stage-5b corrective Natural Harmony Select PDP
composed_at 2026-05-11T17:45:25Z · repo /Users/nish/Documents/Projects/Shopify-Huxberry · review_status APPROVED
Stage-5b corrective re-run handoff. Composes the design bundle into per-section work items for the Liquid Implementation Crew. All v1.4 gates passed: zero protected-file REMOVEs, zero unverified shipped claims, zero forbidden organic / manufacturing-location patterns in customer-facing surfaces or JSON-LD, schema.jsonld passes validate-schema-jsonld.py, prototype-qa.sh findings=0. Two claims remain placeholders (10-year warranty=partial, 100-night trial=unverified) and must be confirmed before going live.
Per-section work plan
| section_id | name | disposition | feasibility | pattern | slots | protected files | notes |
|---|---|---|---|---|---|---|---|
| hero | Hero (ATF gallery + buy-box composite) | EXTEND | extend-with-schema-additions | 7 | sections/product-template.liquidtemplates/product.nish-natural-wool.jsontemplates/product.jsonsnippets/product-hux.liquidsnippets/product-gallery-media-hux.liquidsnippets/cstm-product-price.liquidsnippets/product-buybox-enhancements.liquidsnippets/cstm-product-form-hux.liquid |
Extends sections/product-template.liquid + multiple protected snippets. Slot constraints mandate #537156 resting ATC (corrects live #3A4F3C regression per theme.json). The primary | |
| sticky-add-to-cart | Sticky add-to-cart (mobile split + desktop top bar + in-page nav) | EXTEND | extend-with-schema-additions | 4 | snippets/product-sticky-atc.liquidsections/product-template.liquid |
Mobile path EXTENDs snippets/product-sticky-atc.liquid — the existing snippet is mobile-only; the brief adds split top-strip (fixed_top with rating+count+title) and bottom-footer ( | |
| gallery | Product gallery | EXTEND | clean-extend | 5 | snippets/product-gallery-media-hux.liquidsections/product-template.liquid |
EXTENDs snippets/product-gallery-media-hux.liquid. The 4-slot gallery (main-image, lifestyle-shot, cross-section-diagram, material-detail) + feature-strip-icons matches the existin | |
| buy-box | Buy-box (right column) | EXTEND | extend-with-schema-additions | 7 | snippets/product-hux.liquidsnippets/cstm-product-form-hux.liquidsnippets/cstm-product-price.liquidsnippets/product-buybox-enhancements.liquidsnippets/product-installments.liquidsnippets/product-sleep-bundle.liquidsnippets/product-sleep-bundle-nish.liquidsections/product-template.liquid |
EXTENDs snippets/product-hux.liquid and its dependency chain (cstm-product-form-hux, cstm-product-price, product-buybox-enhancements, product-installments, product-sleep-bundle-nis | |
| trust-strip | Standalone trust stack (under gallery) | EXTEND | extend-with-schema-additions | 3 | snippets/product-trust-stack.liquidsections/product-template.liquid |
EXTENDs snippets/product-trust-stack.liquid. The snippet currently hardcodes 5 CDN cert logo URLs that must be replaced with the NHC-approved set (CertiPUR-US, B Corp, Land to Mark | |
| materials-breakdown | Materials & construction breakdown | EXTEND | clean-extend | 2 | templates/product.nish-natural-wool.json |
EXTENDs sections/icon-with-text-slider.liquid. The 4-card layer stack (Velura cover, NZ wool, pocket-spring core, steel-zoned perimeter) maps directly to the icon-with-text-slider' | |
| comparison-table | Natural Harmony range comparison (Essentia / Select / Reserve) | EXTEND | extend-with-schema-additions | 4 | sections/mattress-comparison.liquidtemplates/product.nish-natural-wool.json |
EXTENDs sections/mattress-comparison.liquid — the section exists and is fully implemented but NOT yet wired into templates/product.nish-natural-wool.json order array. Wiring it req | |
| certifications | Certifications detail band | EXTEND | clean-extend | 2 | snippets/product-buybox-enhancements.liquidsnippets/product-trust-stack.liquid |
EXTENDs snippets/product-buybox-enhancements.liquid as a dedicated cert-detail band, and snippets/product-trust-stack.liquid for the visual framework. The 5 cert items (CertiPUR-US | |
| sleep-trial-and-warranty | Trial & warranty | EXTEND | clean-extend | 4 | snippets/product-buybox-enhancements.liquid |
EXTENDs snippets/product-buybox-enhancements.liquid. Both the trial-block and warranty-block are already metafield-gated in the snippet (huxberry.trial_nights and huxberry.warranty | |
| reviews | Customer reviews | EXTEND | clean-extend | 3 | — | EXTENDs sections/custom-reviews.liquid (CSV-backed review carousel). Section is already in the product.nish-natural-wool.json order array. The aggregate-rating-readout is gated on | |
| faq | FAQ | EXTEND | clean-extend | 2 | — | EXTENDs sections/image-with-faq.liquid. The standalone faq.liquid is disabled in the template; image-with-faq serves the FAQ role per design-reference template. The 5 Q&A entries a | |
| related-products | Related products / cross-sell | EXTEND | clean-extend | 2 | — | EXTENDs sections/static-product-recommendations.liquid — currently disabled (disabled: true) in templates/product.nish-natural-wool.json. Re-enabling it is a flag flip in the templ |
Slot detail (expand each section)
Hero (ATF gallery + buy-box composite) · hero · EXTEND
| slot | kind | source | shipped value / alt |
|---|---|---|---|
| breadcrumbs | microcopy | authored | — |
| product-title | headline | authored | — |
| rating-line | rating | metafield · rating_value |
— |
| atf-trust-badges | trust-strip | authored | [
"Made to order \u2014 ships in 5 working days",
"{{ claim-needed: 10-year warranty }}",
"Free GCC delivery"
] |
| buy-box-form | form | authored | — |
| price-block | price | authored | — |
| delivery-promise | microcopy | authored | Made to order — ships in 5 working days |
Sticky add-to-cart (mobile split + desktop top bar + in-page nav) · sticky-add-to-cart · EXTEND
| slot | kind | source | shipped value / alt |
|---|---|---|---|
| mobile-top-strip | trust-strip | metafield · rating_count |
— |
| mobile-bottom-footer | form | authored | — |
| desktop-top-bar | form | authored | — |
| desktop-in-page-nav | list | authored | [ "Overview", "Reviews", "FAQ", "Layers & Materials", "Product Specs" ] |
Product gallery · gallery · EXTEND
| slot | kind | source | shipped value / alt |
|---|---|---|---|
| main-image | image | authored | — alt: Natural Harmony Select mattress, 30 cm profile, Velura knit cover, front-three-quarter view on neutral linen surface |
| lifestyle-shot | image | authored | — alt: Natural Harmony Select mattress dressed in linen bedding in a warmly lit minimal bedroom |
| cross-section-diagram | image | authored | — alt: Labeled cross-section: Velura cover, NZ Airelle wool layer, CertiPUR-US foam, PU800 pocket-spring core with steel-zoned perimeter |
| material-detail | image | authored | — alt: Macro close-up of Velura TENCEL and cashmere knit cover, showing the woven textile structure |
| feature-strip-icons | list | authored | [ "800-count pocket-spring core", "Steel-zoned perimeter support", "New Zealand wool comfort layer", "Velura knit cover \u2014 TENCEL and cashmere" ] |
Buy-box (right column) · buy-box · EXTEND
| slot | kind | source | shipped value / alt |
|---|---|---|---|
| size-selector | form | authored | — |
| firmness-selector | form | authored | — |
| sleep-bundle-toggle | form | authored | — alt: Sleep Bundle cross-sell products: Organic Cotton Bedding Bundle, ActivChill Mattress Protector, and Organic Latex Pillow |
| primary-atc | cta | authored | Add to cart |
| installment-rows | list | authored | — |
| delivery-line | microcopy | authored | Made to order — ships in 5 working days |
| buybox-enhancements | trust-strip | metafield · show_certs |
— |
Standalone trust stack (under gallery) · trust-strip · EXTEND
| slot | kind | source | shipped value / alt |
|---|---|---|---|
| cert-logo-row | trust-strip | authored | [ "CertiPUR-US", "B Corp", "Land to Market", "FernMark", "OEKO-TEX Standard 100" ] |
| delivery-pill | microcopy | authored | Made to order — ships in 5 working days |
| warranty-pill | microcopy | metafield · warranty_years |
— |
Materials & construction breakdown · materials-breakdown · EXTEND
| slot | kind | source | shipped value / alt |
|---|---|---|---|
| section-heading | headline | authored | Inside the Natural Harmony Select |
| layer-cards | list | authored | [ "Velura knit cover with TENCEL and cashmere \u2014 A breathable knit blend that sits soft against the skin and moves moisture away in warm conditions.", "New Zealand wool comfort layer \u2014 Wool wadding from Wisewool's NZ flock regulates temperature naturally and feels dry on humid Gulf nights.", "800-count pocket-spring core \u2014 Individually wrapped pocket springs at hotel-grade density. Each spring moves on its own to follow the body.", "Steel-zoned perimeter support \u2014 Two perimeter rows of 2.1 mm zoned wire run the length of every side. No foam-encased edge \u2014 breath alt: Natural Harmony Select material layers: pocket-spring core, NZ Airelle wool comfort layer, CertiPUR-US foam, and Velura knit cover |
Natural Harmony range comparison (Essentia / Select / Reserve) · comparison-table · EXTEND
| slot | kind | source | shipped value / alt |
|---|---|---|---|
| section-heading | headline | authored | Compare the Natural Harmony range |
| tier-card-essentia | table | authored | {
"columns": [
"Spec",
"Essentia"
],
"rows": [
[
"Tier",
"Essential"
],
[
"Height",
"27 cm"
],
[
"Build",
"Regular never-turn"
],
[
"Core",
"800-count pocket-spring core"
],
[
"Comfort layer",
"New Zealand wool, entry density"
],
[
"Edge",
"Steel-zoned perimeter support"
],
[
"From",
"Dhs. 3,501"
],
[
"",
"View Essentia"
]
]
}alt: Natural Harmony Essentia mattress, 27 cm height, front-three-quarter view for range comparison |
| tier-card-select | table | authored | {
"columns": [
"Spec",
"Select \u2014 you're viewing"
],
"rows": [
[
"Tier",
"Premier"
],
[
"Height",
"30 cm"
],
[
"Build",
"Regular never-turn"
],
[
"Core",
"800-count pocket-spring core"
],
[
"Comfort layer",
"New Zealand wool, enhanced density with plush comfort foam"
],
[
"Edge",
"Steel-zoned perimeter support"
],
[
"From",
"Dhs. 3,921"
],
[
"",
"You're viewing"
]
]
}alt: Natural Harmony Select mattress, 30 cm height, current product, front-three-quarter view for range comparison |
| tier-card-reserve | table | authored | {
"columns": [
"Spec",
"Reserve"
],
"rows": [
[
"Tier",
"Signature"
],
[
"Height",
"35 cm"
],
[
"Build",
"Euro-top, dual-spring (micropocket above main pocket-spring core)"
],
[
"Core",
"800-count pocket-spring core with micropocket comfort layer"
],
[
"Comfort layer",
"New Zealand wool with cashmere-blended finish"
],
[
"Edge",
"Steel-zoned perimeter support"
],
[
"From",
"Dhs. 5,337"
],
[
"",
"View Reserve"
]
]
}alt: Natural Harmony Reserve mattress, 35 cm Euro-top profile, front-three-quarter view for range comparison |
Certifications detail band · certifications · EXTEND
| slot | kind | source | shipped value / alt |
|---|---|---|---|
| section-heading | headline | authored | The certifications behind this mattress |
| cert-detail-list | list | authored | [ "CertiPUR-US foam \u2014 Tests our comfort foams against limits for harmful substances, low-emission VOCs, and long-term durability.", "Wisewool \u2014 B Corp, Land to Market, FernMark certified. Our New Zealand wool comes from a B Corp supplier whose farms are Land to Market verified for regenerative grazing and FernMark-authenticated as NZ origin.", "Land to Market (via Wisewool) \u2014 Verifies that the wool flock comes from farms practising holistic planned grazing measured against Evidence of Regeneration metrics.", "FernMark (via Wisewool) \u2014 A New Zealand government countr |
Trial & warranty · sleep-trial-and-warranty · EXTEND
| slot | kind | source | shipped value / alt |
|---|---|---|---|
| section-heading | headline | authored | Buy with confidence |
| trial-block | body | metafield · trial_nights |
— |
| warranty-block | body | metafield · warranty_years |
— |
| supporting-image | image | authored | — alt: Warmly lit bedroom with Natural Harmony Select mattress dressed in cream linen, conveying calm confidence |
Customer reviews · reviews · EXTEND
| slot | kind | source | shipped value / alt |
|---|---|---|---|
| section-heading | headline | authored | What our customers say |
| aggregate-rating-readout | rating | metafield · rating_count |
— |
| review-card-list | list | authored | — |
FAQ · faq · EXTEND
| slot | kind | source | shipped value / alt |
|---|---|---|---|
| supporting-image | image | authored | — alt: Natural Harmony Select mattress corner detail showing zoned steel perimeter, in a warmly lit bedroom setting |
| faq-accordion | accordion | authored | [ "Q: Is this mattress suitable for hot, humid Gulf climates? | A: Yes. The New Zealand wool comfort layer wicks moisture away from the body, and the steel-zoned perimeter (no foam-encased edge) keeps the entire side of the mattress breathable. The Velura knit cover with TENCEL and cashmere is engineered to feel dry against the skin in warm conditions.", "Q: What is the difference between Firm and Extra Firm? | A: Both share the same comfort stack and cover. Firm uses a 1.9 mm body wire in the pocket springs, suited to back and combination sleepers. Extra Firm uses a 2.1 mm body wire, suit |
Related products / cross-sell · related-products · EXTEND
| slot | kind | source | shipped value / alt |
|---|---|---|---|
| section-heading | headline | authored | Pairs well with |
| product-card-rail | list | authored | — alt: Huxberry sleep accessories cross-sell: pillow, mattress protector, and bedding bundle product images |
Required metafield definitions
Implementation team scopes the Shopify admin metafield definitions step from this list. Namespace huxberry.
huxberry.awardhuxberry.rating_counthuxberry.rating_valuehuxberry.show_certshuxberry.show_financehuxberry.taglinehuxberry.trial_nightshuxberry.warranty_years
schema.jsonld
Embed via <script type="application/ld+json"> in sections/product-template.liquid head. Source: design/schema.jsonld
Warnings & pre-launch checks
- Claim "10-year warranty" is status=partial — must be verified or removed before going live; renders as { claim-needed } placeholder in prototype only.
- Claim "100-night sleep trial" is status=unverified — must be verified or removed before going live; renders as { claim-needed } placeholder in prototype only.
- Reviewer finding (low):
- Reviewer finding (low):
- Reviewer finding (low):
- Brand color regression in live theme: .product-form--atc-button uses #3A4F3C as resting; must be corrected to #537156 (per brand_color_usage_notes). Implementation team to patch in product-template + cstm-product-form-hux + product-buybox-enhancements snippets.
- Live snippets/product-trust-stack.liquid currently hardcodes GOTS/RWS cert URLs — must be removed for NHC per forbidden_claim_patterns.natural_harmony_collection.organic_claims.