← back to Handcraftedwallpaper

handcraftedwallpaper: rails fire again — wire to matcher + per-site railSynonyms mapping curated rail names to real tag vocab

21e82eaf121ab0775564f5df15a4bde0b66f8712 · 2026-06-11 09:37:05 -0700 · Steve Abrams

Files touched

• M server.js
• M site.config.json

Diff

commit 21e82eaf121ab0775564f5df15a4bde0b66f8712
Author: Steve Abrams <steve@designerwallcoverings.com>
Date:   Thu Jun 11 09:37:05 2026 -0700

    handcraftedwallpaper: rails fire again — wire to matcher + per-site railSynonyms mapping curated rail names to real tag vocab
---
 server.js        | 51 ++++++++++++++++++++++++++++++++++++++++++++-------
 site.config.json | 34 +++++++++++++++++++++++++++++++++-
 2 files changed, 77 insertions(+), 8 deletions(-)

diff --git a/server.js b/server.js
index b88ba29..0179e37 100644
--- a/server.js
+++ b/server.js
@@ -22,6 +22,47 @@ if (ADMIN_ENABLED) {
 const siteCfg = JSON.parse(fs.readFileSync(path.join(__dirname, 'site.config.json'), 'utf8'));
 const SITE_SLUG = siteCfg.slug || __SITE;
 const SITE_RAILS = Array.isArray(siteCfg.rails) ? siteCfg.rails : [];
+// Read-time rail membership: a product belongs to a rail if its `aesthetic` OR
+// any `tag` equals the rail key (or a declared synonym). Naive
+// p.aesthetic === key matching collapses rails when the field is sparse — the
+// richer signal lives in `tags` + per-site railSynonyms. Prefer the shared
+// matcher on dev; fall back to a self-contained copy on prod.
+let railMatch;
+try {
+  railMatch = require('../_shared/rail-match');
+} catch (e) {
+  const norm = s => String(s == null ? '' : s).trim().toLowerCase();
+  const productInRail = (p, key, syn) => {
+    const vals = [norm(key)].concat((syn && Array.isArray(syn[key]) ? syn[key] : []).map(norm));
+    if (vals.includes(norm(p && p.aesthetic))) return true;
+    const tags = p && Array.isArray(p.tags) ? p.tags : [];
+    return tags.some(t => vals.includes(norm(t)));
+  };
+  railMatch = {
+    productInRail,
+    buildRails(products, railKeys, opts) {
+      opts = opts || {}; const syn = opts.synonyms || null;
+      const minShare = opts.minShare != null ? opts.minShare : 0.08;
+      const minItems = opts.minItems != null ? opts.minItems : 4;
+      const perRail = opts.perRail != null ? opts.perRail : 12;
+      const maxShare = opts.maxShare != null ? opts.maxShare : 0.99;
+      const list = Array.isArray(products) ? products : []; const N = list.length || 1; const out = [];
+      for (const key of (railKeys || [])) {
+        const m = list.filter(p => productInRail(p, key, syn)); const c = m.length;
+        if (c >= minItems && c / N >= minShare && c / N <= maxShare) out.push({ key, aesthetic: key, count: c, items: m.slice(0, perRail) });
+      }
+      return out;
+    },
+    railFacets(products, railKeys, syn) {
+      const list = Array.isArray(products) ? products : []; const f = {};
+      for (const key of (railKeys || [])) f[key] = list.filter(p => productInRail(p, key, syn || null)).length;
+      return f;
+    }
+  };
+}
+const { productInRail, buildRails, railFacets } = railMatch;
+let RAIL_SYN = siteCfg.railSynonyms || {};
+if (!siteCfg.railSynonyms) { try { RAIL_SYN = require('../_shared/rail-synonyms.json'); } catch (e) {} }
 
 function isJunk(p) {
   if (!p.image_url || !p.image_url.trim()) return true;
@@ -179,7 +220,7 @@ function filterProducts({ q, aesthetic, vendor }, skip = '') {
     const needle = q.toLowerCase();
     list = list.filter(p => (p.title || '').toLowerCase().includes(needle) || (p.tags || []).some(t => t.toLowerCase().includes(needle)));
   }
-  if (skip !== 'aesthetic' && aesthetic && aesthetic !== 'all') list = list.filter(p => p.aesthetic === aesthetic);
+  if (skip !== 'aesthetic' && aesthetic && aesthetic !== 'all') list = list.filter(p => productInRail(p, aesthetic, RAIL_SYN));
   if (skip !== 'vendor' && vendor && vendor !== 'all') list = list.filter(p => p.vendor === vendor);
   return list;
 }
@@ -197,12 +238,8 @@ app.get('/api/products', (req, res) => {
 });
 
 app.get('/api/sliders', (req, res) => {
-  const out = [];
-  for (const a of SITE_RAILS) {
-    const items = PRODUCTS_NICHE.filter(p => p.aesthetic === a).slice(0, 12);
-    if (items.length >= 4) out.push({ aesthetic: a, items });
-  }
-  res.json({ rails: out });
+  const rails = buildRails(PRODUCTS_NICHE, SITE_RAILS, { synonyms: RAIL_SYN });
+  res.json({ rails: rails.map(r => ({ aesthetic: r.aesthetic, items: r.items })) });
 });
 
 app.get('/api/facets', (req, res) => {
diff --git a/site.config.json b/site.config.json
index e5c61bc..10472b6 100644
--- a/site.config.json
+++ b/site.config.json
@@ -17,5 +17,37 @@
     "custom",
     "heritage"
   ],
-  "port": 9897
+  "port": 9897,
+  "railSynonyms": {
+    "hand-printed": [
+      "block print",
+      "woodblock",
+      "screen print",
+      "printed",
+      "hand printed"
+    ],
+    "artisan": [
+      "cottagecore",
+      "artisanal",
+      "handcrafted",
+      "bespoke"
+    ],
+    "small-batch": [
+      "limited edition",
+      "artisanal",
+      "bespoke"
+    ],
+    "custom": [
+      "bespoke",
+      "made-to-order",
+      "custom"
+    ],
+    "heritage": [
+      "traditional",
+      "classic",
+      "vintage",
+      "antique",
+      "timeless"
+    ]
+  }
 }

← 0f4c927 Recompute aesthetic from tags via classifyAesthetic (was deg  ·  back to Handcraftedwallpaper  ·  fix: safeImg allow same-origin /img/ proxy urls (vendor-neut f0510e4 →