docs(filter-topbar): session update memo — ship-what-works, G1 Contents turnkey + data finding

a826bdecae64893907be5783a47d5aa6cf33c516 · 2026-06-25 16:48:12 -0700 · Steve

Files touched

A pending-approval/boost-filter-topbar-2026-06-25/UPDATE-ship-what-works.md

Diff

commit a826bdecae64893907be5783a47d5aa6cf33c516
Author: Steve <steve@designerwallcoverings.com>
Date:   Thu Jun 25 16:48:12 2026 -0700

    docs(filter-topbar): session update memo — ship-what-works, G1 Contents turnkey + data finding
---
 .../UPDATE-ship-what-works.md                      | 57 ++++++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/pending-approval/boost-filter-topbar-2026-06-25/UPDATE-ship-what-works.md b/pending-approval/boost-filter-topbar-2026-06-25/UPDATE-ship-what-works.md
new file mode 100644
index 00000000..8a3c5ade
--- /dev/null
+++ b/pending-approval/boost-filter-topbar-2026-06-25/UPDATE-ship-what-works.md
@@ -0,0 +1,57 @@
+# Boost Filter Topbar — Session Update (ship-what-works)
+
+**Date:** 2026-06-25 · officer-yolo / vp-dw-commerce · DTD verdict S1+B
+**Theme:** DEV `143794536499` ("Updated copy of NewWall Template [Dev]")
+
+## Status: DONE on DEV, verified. Two gated items remain.
+
+### Completed this session (reversible, committed, staged on DEV)
+- Custom horizontal dropdown topbar built + placed above the Boost grid
+  (dev `collection.json` order: hero → topbar → boost-grid → main).
+- **Replaced** Boost's native toolbar: ported product-type tabs (All/Wallcoverings/
+  Fabrics → `pf_t_product_type`) + a live product count into the topbar; Boost's
+  native `.boost-sd__toolbar` hidden via CSS (cosmetic `display:none` — node stays
+  in DOM, no grid-break surface).
+- **Defaults trimmed to data-backed fields only:** `color, style, brand, contents,
+  price`. Material/Process OFF by default (no catalog data), Pattern OFF (near-unique).
+  All still user-enableable via the ⚙ gear if/when data lands.
+- Commits: a5a75be, fca4c40, 887f840, f7e9dde, 9ec8716. Bugs caught on the DEV push
+  (never reached live): schema 50-char header cap; curl `-g` bracket-glob.
+
+### G1 data finding (30-product live sample of active Wallcoverings)
+| Facet | Source | Fill | Verdict |
+|---|---|---|---|
+| Contents | `global.Contents` metafield | 24/30 (80%) | ✅ add the facet |
+| Material | — | 0/30 | ❌ no data — needs backfill |
+| Process | `global.Finish`/`Construction` | 0/30 | ❌ no data — needs backfill |
+| Pattern | `dwc.pattern_name` | 24/30 but near-unique | ⚠️ needs family-grouping first |
+
+Existing live facets already working: color (`color:` tags), style/brand/durability/
+era (`global.*`), price (`pf_p_price`).
+
+---
+
+## GATED — awaiting Steve
+
+### G1 (Contents facet) — Boost SD dashboard, LIVE customer-facing. Turnkey:
+1. Shopify admin → **Apps → Boost AI Search & Discovery**.
+2. **Filter** (Filter Tree) settings → **Add filter option**.
+3. Source = **Metafield** → `global.Contents` (Single line text).
+4. Display label: **Contents**; type: list/checkbox; sort: alphabetical.
+5. Confirm the emitted param is `pf_t_contents` (matches the topbar's mapping). If
+   Boost assigns a different param (e.g. `pf_opt_contents`), tell me and I'll align
+   the topbar's `contents` field `param` in one edit + re-stage.
+6. Save. The topbar's **Contents** dropdown lights up automatically (it reads Boost's
+   tree). No theme change needed for this to work.
+
+*Note:* this is a LIVE Boost config (store-wide), not theme-scoped. Steve drives it,
+or Claude drives it via the browser MCP **with Steve watching**.
+
+### G3 (LIVE theme publish) — highest gate
+Only after G1 + a final preview eyeball. Publish the section + the merged
+`collection.json` to the LIVE theme (role==main) via the drift-safe push method.
+Steve gives the explicit go.
+
+**Officer sign-off: APPROVE (dev complete) — hold for Steve on G1 + G3.**
+Follow-on (separate, non-blocking): material/process data-tagging backfill +
+pattern-family grouping so those 3 facets can launch later.

← 9ec87169 feat(filter-topbar): ship-what-works — defaults to data-back · back to Designer Wallcoverings · docs(filter-topbar): G3 LIVE publish done — surgical push to 59dba9ea →