@runwell/shopify-toolkit 0.7.0 → 0.9.0

package/bin/runwell-shopify

@@ -8,6 +8,8 @@ import { remove } from '../lib/remove.js';
 import { doctor } from '../lib/doctor.js';
 import { validate } from '../lib/validate.js';
 import { qa } from '../lib/qa.js';
+import { init } from '../lib/init.js';
+import { upgradeBaseline } from '../lib/upgrade-baseline.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -49,6 +51,11 @@ Commands:
   qa                              Code-first QA pipeline (validate-config, doctor,
                                   template-integrity, orphan-assets, theme-check).
                                   Run before any visual QA or "done" declaration.
+  init <client>                   Scaffold a new tenant theme directory pinned to
+                                  the dawn-runwell baseline + toolkit. Use --baseline
+                                  to override the default pin.
+  upgrade-baseline <pkg@version>  Bump the baseline pin in runwell.config.json.
+                                  Run "runwell-shopify sync" after to apply.
   help                            Show this help
 
 Common options:
@@ -86,6 +93,12 @@ flags.toolkitRoot = TOOLKIT_ROOT;
       case 'qa':
         await qa(flags);
         break;
+      case 'init':
+        await init(flags);
+        break;
+      case 'upgrade-baseline':
+        await upgradeBaseline(flags);
+        break;
       case undefined:
       case 'help':
       case '--help':

package/lib/baseline.js

@@ -0,0 +1,203 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { spawnSync } from 'node:child_process';
+import { interpolate } from './template.js';
+
+/* baseline.js: resolve, fetch, and apply the @runwell/dawn-runwell
+   baseline (or another baseline package) into a tenant theme dir.
+
+   Resolution order:
+   1. flags.baselinePath (CLI override)
+   2. config.baseline_path (local dev override in runwell.config.json)
+   3. config.baseline (e.g. "@runwell/dawn-runwell@^1.0.0") via the
+      cache at ~/.runwell/baseline-cache/<pkg>/<version>/
+*/
+
+const CACHE_DIR = path.join(os.homedir(), '.runwell', 'baseline-cache');
+
+export function parseBaselinePin(pin) {
+  if (!pin) return null;
+  // accept "@runwell/dawn-runwell@^1.0.0" or "@runwell/dawn-runwell@latest"
+  const m = pin.match(/^(@?[^@]+)@(.+)$/);
+  if (!m) return { name: pin, version: 'latest' };
+  return { name: m[1], version: m[2] };
+}
+
+export function resolveBaseline(flags, config) {
+  if (flags && flags.baselinePath) return flags.baselinePath;
+  if (config && config.baseline_path) return path.resolve(config.baseline_path);
+  if (!config || !config.baseline) return null;
+
+  const pin = parseBaselinePin(config.baseline);
+  if (!pin) return null;
+  const safeName = pin.name.replace('/', '__');
+  const versionDir = path.join(CACHE_DIR, safeName, pin.version);
+
+  if (fs.existsSync(path.join(versionDir, 'baseline-manifest.json'))) {
+    return versionDir;
+  }
+
+  // Cache miss: fetch via npm pack
+  console.log(`Fetching baseline: ${pin.name}@${pin.version} ...`);
+  fs.mkdirSync(versionDir, { recursive: true });
+  const packResult = spawnSync('npm', ['pack', `${pin.name}@${pin.version}`, '--pack-destination', versionDir], {
+    stdio: 'pipe',
+    encoding: 'utf8'
+  });
+  if (packResult.status !== 0) {
+    throw new Error(`npm pack failed: ${packResult.stderr || packResult.stdout}`);
+  }
+  const tarball = packResult.stdout.trim().split('\n').pop();
+  const tarPath = path.join(versionDir, tarball);
+  // npm pack delivers a tarball that extracts to ./package/
+  const tarResult = spawnSync('tar', ['-xzf', tarPath, '-C', versionDir, '--strip-components=1'], { stdio: 'inherit' });
+  if (tarResult.status !== 0) throw new Error('tar extract failed');
+  fs.unlinkSync(tarPath);
+  return versionDir;
+}
+
+export function loadBaselineManifest(baselineRoot) {
+  const p = path.join(baselineRoot, 'baseline-manifest.json');
+  if (!fs.existsSync(p)) {
+    throw new Error(`baseline-manifest.json not found at ${p}`);
+  }
+  return JSON.parse(fs.readFileSync(p, 'utf8'));
+}
+
+export async function syncBaseline({ baselineRoot, targetDir, config, dryRun, written }) {
+  const manifest = loadBaselineManifest(baselineRoot);
+  console.log(`\n[baseline: ${manifest.name}@${manifest.version}]`);
+
+  const interpolationVars = {
+    config: {},
+    brand: config.brand || {},
+    client: { name: config.client, store: config.store }
+  };
+
+  // 1. Owned files (verbatim or interpolated)
+  for (const [bucket, files] of Object.entries(manifest.files || {})) {
+    if (!Array.isArray(files)) continue;
+    const targetSubdir = bucketToTargetDir(bucket, targetDir);
+    if (!targetSubdir) continue;
+    for (const rel of files) {
+      const sourcePath = path.join(baselineRoot, bucket, rel);
+      if (!fs.existsSync(sourcePath)) {
+        console.warn(`  [warn] missing baseline source: ${bucket}/${rel}`);
+        continue;
+      }
+      const filename = path.basename(rel);
+      const targetPath = path.join(targetSubdir, filename);
+      const isText = isTextFile(filename);
+      let content = fs.readFileSync(sourcePath, isText ? 'utf8' : null);
+      if (isText) content = interpolate(content, interpolationVars);
+      if (!dryRun) {
+        fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+        fs.writeFileSync(targetPath, content);
+      }
+      console.log(`  + ${path.relative(targetDir, targetPath)}`);
+      written.push({ source: 'baseline', target: targetPath, bucket, baseline_version: manifest.version });
+    }
+  }
+
+  // 2. Patches (deep-merge into existing tenant files)
+  for (const [tenantRel, patchRel] of Object.entries(manifest.patches || {})) {
+    const patchPath = path.join(baselineRoot, patchRel);
+    const tenantPath = path.join(targetDir, tenantRel);
+    if (!fs.existsSync(patchPath)) {
+      console.warn(`  [warn] missing baseline patch: ${patchRel}`);
+      continue;
+    }
+    if (!fs.existsSync(tenantPath)) {
+      console.warn(`  [warn] tenant file ${tenantRel} not present; skipping patch (run shopify theme pull first)`);
+      continue;
+    }
+    const patchData = JSON.parse(fs.readFileSync(patchPath, 'utf8'));
+    const tenantData = JSON.parse(fs.readFileSync(tenantPath, 'utf8'));
+    if (tenantRel === 'config/settings_schema.json') {
+      applySettingsPatches(tenantData, patchData);
+    } else if (tenantRel.startsWith('locales/')) {
+      deepMerge(tenantData, patchData.patches || {});
+    } else {
+      deepMerge(tenantData, patchData);
+    }
+    if (!dryRun) {
+      fs.writeFileSync(tenantPath, JSON.stringify(tenantData, null, 2) + '\n');
+    }
+    console.log(`  ~ patched ${tenantRel}`);
+    written.push({ source: 'baseline-patch', target: tenantPath, bucket: 'patch', baseline_version: manifest.version });
+  }
+}
+
+function applySettingsPatches(tenantSchema, patchDoc) {
+  // tenantSchema is an array of setting groups. patchDoc.patches is an array.
+  const patches = patchDoc.patches || [];
+  for (const patchGroup of patches) {
+    const existing = tenantSchema.find(g => g.name === patchGroup.name);
+    if (!existing) {
+      tenantSchema.push(patchGroup);
+    } else {
+      // Merge settings, skipping duplicates by id (or by content for header/paragraph)
+      const existingIds = new Set((existing.settings || []).map(s => s.id).filter(Boolean));
+      for (const s of patchGroup.settings || []) {
+        if (s.id && existingIds.has(s.id)) continue;
+        existing.settings = existing.settings || [];
+        existing.settings.push(s);
+      }
+    }
+  }
+}
+
+function deepMerge(target, source) {
+  for (const key of Object.keys(source)) {
+    if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
+      target[key] = target[key] || {};
+      deepMerge(target[key], source[key]);
+    } else {
+      target[key] = source[key];
+    }
+  }
+}
+
+function bucketToTargetDir(bucket, targetDir) {
+  switch (bucket) {
+    case 'assets':         return path.join(targetDir, 'assets');
+    case 'snippets':       return path.join(targetDir, 'snippets');
+    case 'sections':       return path.join(targetDir, 'sections');
+    case 'templates':      return path.join(targetDir, 'templates');
+    case 'layout':         return path.join(targetDir, 'layout');
+    case 'locales':        return path.join(targetDir, 'locales');
+    case 'config':         return path.join(targetDir, 'config');
+    default: return null;
+  }
+}
+
+function isTextFile(filename) {
+  const ext = path.extname(filename).toLowerCase();
+  return ['.liquid', '.js', '.css', '.json', '.html', '.svg', '.md', '.txt'].includes(ext);
+}
+
+export async function applyTenantOverrides({ targetDir, dryRun, written }) {
+  const overridesDir = path.join(targetDir, 'tenant-overrides');
+  if (!fs.existsSync(overridesDir)) return;
+  console.log(`\n[tenant-overrides]`);
+  walkAndCopy(overridesDir, targetDir, overridesDir, dryRun, written);
+}
+
+function walkAndCopy(srcRoot, dstRoot, currentDir, dryRun, written) {
+  for (const entry of fs.readdirSync(currentDir, { withFileTypes: true })) {
+    const srcPath = path.join(currentDir, entry.name);
+    const rel = path.relative(srcRoot, srcPath);
+    const dstPath = path.join(dstRoot, rel);
+    if (entry.isDirectory()) {
+      walkAndCopy(srcRoot, dstRoot, srcPath, dryRun, written);
+    } else {
+      if (!dryRun) {
+        fs.mkdirSync(path.dirname(dstPath), { recursive: true });
+        fs.copyFileSync(srcPath, dstPath);
+      }
+      console.log(`  + ${rel}`);
+      written.push({ source: 'tenant-override', target: dstPath, bucket: 'override' });
+    }
+  }
+}

package/lib/init.js

@@ -0,0 +1,122 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+/* runwell-shopify init <client> [--baseline <pin>]: scaffold a new
+   tenant theme directory with the minimum required files.
+*/
+
+export async function init(flags) {
+  const client = flags.positional && flags.positional[0];
+  if (!client) {
+    console.error('Usage: runwell-shopify init <client-name> [--baseline @runwell/dawn-runwell@^1.0.0] [--target ./<dir>]');
+    process.exit(1);
+  }
+
+  const targetDir = path.resolve(flags.target || `./${client}-shopify`);
+  if (fs.existsSync(targetDir) && fs.readdirSync(targetDir).length > 0) {
+    console.error(`Target directory ${targetDir} is not empty. Choose another path or remove existing contents.`);
+    process.exit(1);
+  }
+
+  fs.mkdirSync(targetDir, { recursive: true });
+  for (const d of ['layout', 'sections', 'snippets', 'assets', 'config', 'locales', 'templates', 'tenant-overrides']) {
+    fs.mkdirSync(path.join(targetDir, d), { recursive: true });
+  }
+
+  const baseline = flags.baseline || '@runwell/dawn-runwell@^1.0.0';
+
+  const config = {
+    client,
+    store: 'TODO.myshopify.com',
+    theme_path: '.',
+    baseline,
+    toolkit_version: '^0.9.0',
+    brand: {
+      name: client.charAt(0).toUpperCase() + client.slice(1),
+      primary: '#1A1A1A',
+      accent: '#D4AF37',
+      cream: '#F5EFE6',
+      currency: 'USD',
+      support_email: `support@${client}.com`,
+      tagline: ''
+    },
+    modules: {
+      '_shared/css-tokens': { enabled: true, config: {} }
+    }
+  };
+
+  fs.writeFileSync(path.join(targetDir, 'runwell.config.json'), JSON.stringify(config, null, 2) + '\n');
+
+  // Scaffold templates
+  fs.writeFileSync(
+    path.join(targetDir, 'templates', 'index.json'),
+    JSON.stringify({ sections: {}, order: [] }, null, 2) + '\n'
+  );
+  fs.writeFileSync(
+    path.join(targetDir, 'templates', 'product.json'),
+    JSON.stringify({
+      sections: {
+        main: {
+          type: 'main-product',
+          blocks: {
+            title: { type: 'title' },
+            price: { type: 'price' },
+            buy_buttons: { type: 'buy_buttons', settings: { show_dynamic_checkout: true } }
+          },
+          block_order: ['title', 'price', 'buy_buttons'],
+          settings: {}
+        }
+      },
+      order: ['main']
+    }, null, 2) + '\n'
+  );
+
+  // README
+  fs.writeFileSync(
+    path.join(targetDir, 'README.md'),
+    `# ${client} Shopify theme
+
+Tenant theme for ${client}, built on @runwell/dawn-runwell + @runwell/shopify-toolkit.
+
+## Lock context (always state these before any work)
+
+- Client: ${client}
+- Store: TODO.myshopify.com
+- Theme ID: TODO
+- Storefront password: TODO
+
+## Quick start
+
+\`\`\`bash
+# 1. Edit runwell.config.json with the real store handle + brand values
+# 2. Sync baseline + toolkit + tenant overrides into the theme dir
+runwell-shopify sync
+
+# 3. Code QA before any push
+runwell-shopify qa
+
+# 4. Push to a NEW unpublished theme on the store
+shopify theme push -u -s <store>.myshopify.com
+
+# 5. Once happy, push to the live theme
+shopify theme push -t <THEME_ID> -l -a -s <store>.myshopify.com
+\`\`\`
+
+## Layers
+
+1. \`@runwell/dawn-runwell\` baseline (pinned in runwell.config.json).
+2. \`@runwell/shopify-toolkit\` modules (declared in runwell.config.json modules block).
+3. This repo: \`tenant-overrides/\` directory + \`templates/*.json\` + bespoke sections + brand assets.
+
+\`runwell-manifest.json\` is regenerated on every sync and tracks file provenance.
+`
+  );
+
+  console.log(`Scaffolded ${client} tenant theme at ${targetDir}`);
+  console.log(`\nNext steps:`);
+  console.log(`  1. cd ${path.relative(process.cwd(), targetDir) || '.'}`);
+  console.log(`  2. Edit runwell.config.json: set store handle + brand values`);
+  console.log(`  3. runwell-shopify sync`);
+  console.log(`  4. runwell-shopify qa`);
+  console.log(`  5. shopify theme push -u -s <store>`);
+}

package/lib/sync.js

@@ -2,6 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { loadConfig, loadModuleManifest, listAvailableModules, resolveVariant } from './config-loader.js';
 import { interpolate } from './template.js';
+import { resolveBaseline, syncBaseline, applyTenantOverrides } from './baseline.js';
 
 export async function sync(flags) {
   const configPath = flags.config || './runwell.config.json';
@@ -18,6 +19,14 @@ export async function sync(flags) {
   const writtenFiles = [];
   const removedFiles = [];
 
+  // Stage 1: baseline (if configured). Owned files + patches first;
+  // toolkit module files in stage 2 will overlay on top, and tenant
+  // overrides in stage 3 win last.
+  const baselineRoot = resolveBaseline(flags, config);
+  if (baselineRoot) {
+    await syncBaseline({ baselineRoot, targetDir, config, dryRun, written: writtenFiles });
+  }
+
   const moduleNames = Object.keys(config.modules);
   for (const moduleName of moduleNames) {
     const cfgEntry = config.modules[moduleName];
@@ -77,15 +86,21 @@ export async function sync(flags) {
     }
   }
 
-  // Manifest
+  // Stage 3: tenant overrides (last; wins over baseline + toolkit).
+  await applyTenantOverrides({ targetDir, dryRun, written: writtenFiles });
+
+  // Manifest with provenance per file.
   const manifestPath = path.join(targetDir, 'runwell-manifest.json');
   const manifestData = {
     generated_at: new Date().toISOString(),
     toolkit_version: getToolkitVersion(flags.toolkitRoot),
+    baseline_version: writtenFiles.find(f => f.source === 'baseline')?.baseline_version || null,
     client: config.client,
     files: writtenFiles.map(f => ({
+      source: f.source || 'toolkit',
       module: f.module,
       bucket: f.bucket,
+      baseline_version: f.baseline_version,
       path: path.relative(targetDir, f.target)
     }))
   };

package/lib/upgrade-baseline.js

@@ -0,0 +1,25 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { loadConfig } from './config-loader.js';
+
+/* runwell-shopify upgrade-baseline <pin>: bump the baseline version pin
+   in runwell.config.json. Subsequent runwell-shopify sync uses the new
+   pin to fetch the new baseline. Caller is responsible for running sync
+   + qa + push afterwards.
+*/
+
+export async function upgradeBaseline(flags) {
+  const newPin = flags.positional && flags.positional[0];
+  if (!newPin) {
+    console.error('Usage: runwell-shopify upgrade-baseline <package@version>');
+    console.error('Example: runwell-shopify upgrade-baseline @runwell/dawn-runwell@1.1.0');
+    process.exit(1);
+  }
+  const configPath = path.resolve(flags.config || './runwell.config.json');
+  const { config } = loadConfig(configPath);
+  const oldPin = config.baseline || '(unset)';
+  config.baseline = newPin;
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+  console.log(`baseline: ${oldPin} -> ${newPin}`);
+  console.log(`Run 'runwell-shopify sync' to apply, then 'runwell-shopify qa' before pushing.`);
+}

package/modules/comparison-table/variants/feature-columns/sections/runwell-comparison-table.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi product comparison table. Drops on PDP (or any template) to
+  Runwell product comparison table. Drops on PDP (or any template) to
   compare attributes across Lushi products or against a competitor.
   Editorial style, not a feature dump. Per CRO §5.2 (decision-aid for
   high-trust niches).
@@ -84,7 +84,7 @@
 
 {% schema %}
 {
-  "name": "Lushi comparison table",
+  "name": "Runwell comparison table",
   "tag": "section",
   "class": "section-runwell-comparison",
   "settings": [
@@ -145,7 +145,7 @@
   "max_blocks": 4,
   "presets": [
     {
-      "name": "Lushi comparison table",
+      "name": "Runwell comparison table",
       "blocks": [
         { "type": "column", "settings": { "column_title": "Lushi pick", "column_subtitle": "This product" } },
         { "type": "column", "settings": { "column_title": "Drugstore", "column_subtitle": "Average mass-market option" } },

package/modules/delivery-estimate/snippets/runwell-delivery-estimate.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi delivery estimate. Renders a placeholder span filled by JS with
+  Runwell delivery estimate. Renders a placeholder span filled by JS with
   a date range based on cutoff time and standard transit. Native
   replacement for the Estimated Delivery Date widget in Vitals etc.
 {%- endcomment -%}

package/modules/editorial-block/sections/runwell-editorial-block.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi v2 editorial section: eyebrow + serif italic heading + lede + body.
+  Runwell editorial section: eyebrow + serif italic heading + lede + body.
   Used for the homepage section flow (Approach, Press, Partnering equivalents).
 {%- endcomment -%}
 
@@ -66,7 +66,7 @@
 
 {% schema %}
 {
-  "name": "Lushi editorial block",
+  "name": "Runwell editorial block",
   "tag": "section",
   "class": "section-runwell-editorial",
   "settings": [
@@ -143,7 +143,7 @@
   ],
   "presets": [
     {
-      "name": "Lushi editorial block",
+      "name": "Runwell editorial block",
       "blocks": [
         { "type": "card" },
         { "type": "card" },

package/modules/editorial-hero/variants/video-bg/sections/runwell-video-hero.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi v2 video hero. Full-bleed background video with editorial copy
+  Runwell video hero. Full-bleed background video with editorial copy
   bottom-left. Mirrors the v1 lushi.co Hero pattern but pivots messaging
   to general health and wellness.
 {%- endcomment -%}
@@ -76,7 +76,7 @@
 
 {% schema %}
 {
-  "name": "Lushi video hero",
+  "name": "Runwell video hero",
   "tag": "section",
   "class": "section-runwell-video-hero",
   "settings": [
@@ -150,7 +150,7 @@
   ],
   "presets": [
     {
-      "name": "Lushi video hero"
+      "name": "Runwell video hero"
     }
   ]
 }

package/modules/exit-intent/sections/runwell-exit-intent.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi exit-intent newsletter popup. Native replacement for Privy /
+  Runwell exit-intent newsletter popup. Native replacement for Privy /
   Justuno / Uno popups. Triggers on mouseleave at top of viewport
   (desktop) or after 30 seconds (mobile fallback). Suppresses with a
   localStorage cookie for 30 days after dismiss or sign-up.
@@ -33,7 +33,7 @@
 
 {% schema %}
 {
-  "name": "Lushi exit popup",
+  "name": "Runwell exit popup",
   "tag": "section",
   "class": "section-runwell-exit",
   "settings": [
@@ -42,7 +42,7 @@
     { "type": "textarea", "id": "lede", "label": "Lede", "default": "Join the journal and get the founder's take on what we picked, why we picked it, and which products to skip altogether." }
   ],
   "presets": [
-    { "name": "Lushi exit popup" }
+    { "name": "Runwell exit popup" }
   ]
 }
 {% endschema %}

package/modules/faq/sections/runwell-faq.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi FAQ accordion. Native replacement for FAQ widgets in Vitals,
+  Runwell FAQ accordion. Native replacement for FAQ widgets in Vitals,
   HelpCenter, etc. Uses native HTML <details> elements so it works
   without any JS.
 {%- endcomment -%}
@@ -30,7 +30,7 @@
 
 {% schema %}
 {
-  "name": "Lushi FAQ",
+  "name": "Runwell FAQ",
   "tag": "section",
   "class": "section-runwell-faq",
   "settings": [
@@ -52,12 +52,12 @@
   "max_blocks": 12,
   "presets": [
     {
-      "name": "Lushi FAQ",
+      "name": "Runwell FAQ",
       "blocks": [
-        { "type": "qa", "settings": { "question": "Are these supplements third-party tested?", "answer": "<p>Every product we list ships with a published Certificate of Analysis from the supplier. We confirm the lot numbers match what the bottle claims before any product gets a page on Lushi.</p>" } },
+        { "type": "qa", "settings": { "question": "Are these supplements third-party tested?", "answer": "<p>Every product we list ships with a published Certificate of Analysis from the supplier. We confirm the lot numbers match what the bottle claims before any product gets a page on the site.</p>" } },
         { "type": "qa", "settings": { "question": "How fast do orders ship?", "answer": "<p>Most orders leave the warehouse within one to two business days. Free standard shipping on US orders over $75; flat $7 below. International rates calculated at checkout.</p>" } },
         { "type": "qa", "settings": { "question": "What is the return policy?", "answer": "<p>If a product does not earn a place on your counter, write to us within 30 days for a full refund. We do not make returns hard.</p>" } },
-        { "type": "qa", "settings": { "question": "Do these products treat or cure conditions?", "answer": "<p>No. Statements about supplements and skincare on Lushi have not been evaluated by the FDA and are not intended to diagnose, treat, cure, or prevent any disease. Consult your physician before starting any new regimen.</p>" } },
+        { "type": "qa", "settings": { "question": "Do these products treat or cure conditions?", "answer": "<p>No. Statements about supplements and skincare on this site have not been evaluated by the FDA and are not intended to diagnose, treat, cure, or prevent any disease. Consult your physician before starting any new regimen.</p>" } },
         { "type": "qa", "settings": { "question": "How does the journal work?", "answer": "<p>Every product is paired with a journal post explaining how it works, who it is for, and what the research actually says. Editorial, not advertorial.</p>" } }
       ]
     }

package/modules/how-it-works/sections/runwell-how-it-works.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi "How it works" section. Side-image left + content right (or
+  Runwell "How it works" section. Side-image left + content right (or
   reversible). Eyebrow + headline + lede + 3 numbered service cards.
   Mirrors v1 .conciergeSection / "Nationwide Access to Concierge Care"
   but pivoted to wellness curation flow.
@@ -60,11 +60,11 @@
 
 {% schema %}
 {
-  "name": "Lushi how it works",
+  "name": "Runwell how it works",
   "tag": "section",
   "class": "section-runwell-how",
   "settings": [
-    { "type": "text", "id": "eyebrow", "label": "Eyebrow", "default": "How Lushi works" },
+    { "type": "text", "id": "eyebrow", "label": "Eyebrow", "default": "How it works" },
     { "type": "text", "id": "heading", "label": "Heading", "default": "Curated, written, shipped." },
     { "type": "textarea", "id": "lede", "label": "Lede", "default": "Three simple steps from the brands we trust to your counter. No filler in between." },
     { "type": "image_picker", "id": "image", "label": "Side image (uploaded)" },
@@ -87,9 +87,9 @@
   "max_blocks": 4,
   "presets": [
     {
-      "name": "Lushi how it works",
+      "name": "Runwell how it works",
       "blocks": [
-        { "type": "step", "settings": { "title": "We curate.", "body": "Every product on Lushi is hand-picked from small wellness brands and clears our four-check standards before it gets a page." } },
+        { "type": "step", "settings": { "title": "We curate.", "body": "Every product is hand-picked and clears our standards before it gets a page." } },
         { "type": "step", "settings": { "title": "We write.", "body": "Each product pairs with a journal post: how it works, who it's for, and what the research actually says. Editorial, not advertorial." } },
         { "type": "step", "settings": { "title": "We ship.", "body": "Suppliers ship direct from their facility. Free shipping over $75; 30-day no-hassle returns." } }
       ]

package/modules/inventory-urgency/snippets/runwell-inventory-urgency.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi inventory urgency. Shows "Only N left" near ATC when stock is
+  Runwell inventory urgency. Shows "Only N left" near ATC when stock is
   low. Replaces the urgency widget from Vitals / similar apps.
   Threshold and display are conservative: only fires when inventory is
   tracked AND visible on the PDP product object.

package/modules/pdp-ingredients/sections/runwell-ingredients.liquid

@@ -1,11 +1,12 @@
 {%- comment -%}
-  Lushi ingredient grid. Drops below a PDP description (or anywhere) and
+  Runwell ingredient grid. Drops below a PDP description (or anywhere) and
   spotlights 3 to 6 hero ingredients with name, role, and dose. Reads
-  product.metafields.lushi.ingredients (list.metaobject) when set, with
+  product.metafields.<namespace>.ingredients (list.metaobject, default namespace runwell) when set, with
   manual blocks as the fallback.
 {%- endcomment -%}
 
-{%- assign ingredients_meta = product.metafields.lushi.ingredients.value -%}
+{%- assign ns = section.settings.metafield_namespace | default: 'runwell' -%}
+{%- assign ingredients_meta = product.metafields[ns].ingredients.value -%}
 
 <section
   class="runwell-ingredients"
@@ -74,7 +75,7 @@
 
 {% schema %}
 {
-  "name": "Lushi ingredients",
+  "name": "Runwell ingredients",
   "tag": "section",
   "class": "section-runwell-ingredients",
   "settings": [
@@ -84,6 +85,13 @@
       "label": "Eyebrow",
       "default": "What's inside"
     },
+    {
+      "type": "text",
+      "id": "metafield_namespace",
+      "label": "Ingredients metafield namespace",
+      "default": "runwell",
+      "info": "Reads product.metafields.<namespace>.ingredients (list.metaobject)."
+    },
     {
       "type": "text",
       "id": "heading",
@@ -110,7 +118,7 @@
     },
     {
       "type": "paragraph",
-      "content": "If product.metafields.lushi.ingredients is set, those are used and the blocks below are ignored."
+      "content": "If product.metafields.<namespace>.ingredients is set, those are used and the blocks below are ignored."
     }
   ],
   "blocks": [
@@ -127,7 +135,7 @@
   "max_blocks": 8,
   "presets": [
     {
-      "name": "Lushi ingredients",
+      "name": "Runwell ingredients",
       "blocks": [
         { "type": "ingredient", "settings": { "name": "Magnesium glycinate", "dose": "200mg", "role": "The most bioavailable form of magnesium. Supports sleep onset and muscle recovery." } },
         { "type": "ingredient", "settings": { "name": "L-theanine", "dose": "100mg", "role": "Amino acid from green tea. Calms without sedating; pairs well with magnesium." } },

package/modules/pdp-journal-link/sections/runwell-pdp-journal.liquid

@@ -1,11 +1,13 @@
 {%- comment -%}
-  Lushi PDP journal link. Connects a product to the editorial article that
-  explains why it's on Lushi. Uses the product's metafield
-  `lushi.journal_article` if set, otherwise falls back to the linked
-  article picked in the section settings, otherwise the manual title.
+  Runwell PDP journal link. Connects a product to the editorial article
+  that explains why we carry it. Uses the product metafield
+  `<namespace>.journal_article` (default namespace 'runwell', overridable
+  per-client). Falls back to the section settings article picker, then
+  the manual title.
 {%- endcomment -%}
 
-{%- assign linked_article = product.metafields.lushi.journal_article.value -%}
+{%- assign ns = section.settings.metafield_namespace | default: 'runwell' -%}
+{%- assign linked_article = product.metafields[ns].journal_article.value -%}
 {%- if linked_article == blank -%}
   {%- assign linked_article = section.settings.article -%}
 {%- endif -%}
@@ -59,7 +61,7 @@
 
 {% schema %}
 {
-  "name": "Lushi PDP journal link",
+  "name": "Runwell PDP journal link",
   "tag": "section",
   "class": "section-runwell-pdp-journal",
   "settings": [
@@ -69,11 +71,18 @@
       "label": "Eyebrow",
       "default": "From the journal"
     },
+    {
+      "type": "text",
+      "id": "metafield_namespace",
+      "label": "Journal metafield namespace",
+      "default": "runwell",
+      "info": "Reads product.metafields.<namespace>.journal_article. Default: runwell."
+    },
     {
       "type": "article",
       "id": "article",
       "label": "Linked article (override)",
-      "info": "Optional. If set, overrides the product's lushi.journal_article metafield."
+      "info": "Optional. If set, overrides the product's <namespace>.journal_article metafield."
     },
     {
       "type": "color",
@@ -101,7 +110,7 @@
       "type": "textarea",
       "id": "fallback_body",
       "label": "Fallback body",
-      "default": "Every product on Lushi pairs with a journal article. Browse the full archive to dig deeper."
+      "default": "Every product we carry pairs with a journal article. Browse the full archive to dig deeper."
     },
     {
       "type": "text",
@@ -117,7 +126,7 @@
   ],
   "presets": [
     {
-      "name": "Lushi PDP journal link"
+      "name": "Runwell PDP journal link"
     }
   ]
 }

package/modules/pdp-trust-checks/sections/runwell-pdp-trust.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi PDP trust block. Shows the four-check standards on every PDP.
+  Runwell PDP trust block. Shows the four-check standards on every PDP.
   Builds buyer trust the way Goop's "What it is / what it does" panels do.
   Drop into product.json after the main-product section.
 {%- endcomment -%}
@@ -56,7 +56,7 @@
 
 {% schema %}
 {
-  "name": "Lushi PDP trust",
+  "name": "Runwell PDP trust",
   "tag": "section",
   "class": "section-runwell-pdp-trust",
   "settings": [
@@ -76,7 +76,7 @@
       "type": "textarea",
       "id": "lede",
       "label": "Lede",
-      "default": "We do not stock everything. Every product on Lushi has to clear these four checks before it gets a page."
+      "default": "We do not stock everything. Every product has to clear these four checks before it gets a page."
     },
     {
       "type": "color",
@@ -128,7 +128,7 @@
   ],
   "presets": [
     {
-      "name": "Lushi PDP trust",
+      "name": "Runwell PDP trust",
       "blocks": [
         { "type": "check", "settings": { "eyebrow": "Check 01", "title": "Ingredients we trust.", "body": "Whole-food forms over synthetic where the science holds. Synthetic where it works better, with a clear reason why." } },
         { "type": "check", "settings": { "eyebrow": "Check 02", "title": "Doses that match research.", "body": "We check actual doses against published trials. No buzzword ingredients at one-tenth the studied dose." } },

package/modules/press-bar/sections/runwell-press-bar.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi press bar. Logos in a row with optional eyebrow text and link.
+  Runwell press bar. Logos in a row with optional eyebrow text and link.
   Used on homepage and about page. Keep tight; the wins do the talking.
 
   Block options (in priority order):
@@ -52,7 +52,7 @@
 
 {% schema %}
 {
-  "name": "Lushi press bar",
+  "name": "Runwell press bar",
   "tag": "section",
   "class": "section-runwell-press-bar",
   "settings": [
@@ -104,7 +104,7 @@
   "max_blocks": 9,
   "presets": [
     {
-      "name": "Lushi press bar",
+      "name": "Runwell press bar",
       "blocks": [
         { "type": "logo", "settings": { "label": "Bloomberg",       "asset_filename": "runwell-press-bloomberg.png" } },
         { "type": "logo", "settings": { "label": "Yahoo Finance",   "asset_filename": "runwell-press-yahoo-finance.png" } },

package/modules/recently-viewed/sections/runwell-recently-viewed.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi recently-viewed products. Reads from localStorage (populated on
+  Runwell recently-viewed products. Reads from localStorage (populated on
   PDP visits) and renders up to 4 cards. Native replacement for the
   recently-viewed feature in Vitals / similar apps.
 {%- endcomment -%}
@@ -23,7 +23,7 @@
 
 {% schema %}
 {
-  "name": "Lushi recently viewed",
+  "name": "Runwell recently viewed",
   "tag": "section",
   "class": "section-runwell-rv",
   "settings": [
@@ -32,7 +32,7 @@
     { "type": "color", "id": "background_color", "label": "Background", "default": "#FFFFFF" }
   ],
   "presets": [
-    { "name": "Lushi recently viewed" }
+    { "name": "Runwell recently viewed" }
   ]
 }
 {% endschema %}

package/modules/reviews/sections/runwell-pdp-reviews.liquid

@@ -1,12 +1,15 @@
 {%- comment -%}
-  Lushi native PDP reviews. Replaces Stamped / Loox display layer.
-  Reads from product metafield `lushi.reviews` (json type) where each
-  entry is { name, location, rating, body, date, verified }.
-  Falls back to a "no reviews yet" state with a CTA to email a review.
+  Runwell native PDP reviews. Replaces Stamped / Loox display layer.
+  Reads from product metafield `<namespace>.reviews` (json type, default
+  namespace 'runwell', overridable per-client via section setting).
+  Each entry is { name, location, rating, body, date, verified }.
+  Falls back to a "no reviews yet" state with a mailto CTA pointing
+  to shop.email (merchant configures in Shopify admin > settings).
 {%- endcomment -%}
 
 {%- if product != blank -%}
-  {%- assign reviews_json = product.metafields.lushi.reviews.value -%}
+  {%- assign ns = section.settings.metafield_namespace | default: 'runwell' -%}
+  {%- assign reviews_json = product.metafields[ns].reviews.value -%}
   <section class="runwell-reviews" data-runwell-reviews>
     <div class="runwell-reviews__inner">
       <header class="runwell-reviews__header">
@@ -45,7 +48,9 @@
         </ul>
       {%- else -%}
         <div class="runwell-reviews__empty">
-          <p>No reviews on this one yet. If you have tried it, write us at <a href="mailto:hello@lushi.co?subject=Review for {{ product.title | escape }}">hello@lushi.co</a> and we will publish thoughtful reviews on the page.</p>
+          {%- comment -%}brand.support_email is interpolated at sync time from runwell.config.json; falls back to Shopify admin shop.email if the brand var is unset.{%- endcomment -%}
+          {%- assign reply_to = '{{brand.support_email}}' | default: shop.email | default: shop.url -%}
+          <p>No reviews on this one yet. If you have tried it, write us at <a href="mailto:{{ reply_to }}?subject=Review for {{ product.title | escape }}">{{ reply_to }}</a> and we will publish thoughtful reviews on the page.</p>
         </div>
       {%- endif -%}
 
@@ -79,14 +84,15 @@
 
 {% schema %}
 {
-  "name": "Lushi PDP reviews",
+  "name": "Runwell PDP reviews",
   "tag": "section",
   "class": "section-runwell-pdp-reviews",
   "settings": [
-    { "type": "text", "id": "heading", "label": "Heading", "default": "What customers wrote in." }
+    { "type": "text", "id": "heading", "label": "Heading", "default": "What customers wrote in." },
+    { "type": "text", "id": "metafield_namespace", "label": "Reviews metafield namespace", "default": "runwell", "info": "Reads product.metafields.<namespace>.reviews. Default: runwell." }
   ],
   "presets": [
-    { "name": "Lushi PDP reviews" }
+    { "name": "Runwell PDP reviews" }
   ]
 }
 {% endschema %}

package/modules/risk-reversal/sections/runwell-risk-reversal.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi risk-reversal block. Small, calm reassurance that drops directly
+  Runwell risk-reversal block. Small, calm reassurance that drops directly
   under the PDP buy form (or anywhere the editor wants reassurance).
   Per CRO §5.3 (foundational trust signal under add-to-cart).
 {%- endcomment -%}
@@ -39,7 +39,7 @@
 
 {% schema %}
 {
-  "name": "Lushi risk reversal",
+  "name": "Runwell risk reversal",
   "tag": "section",
   "class": "section-runwell-risk-reversal",
   "settings": [
@@ -87,7 +87,7 @@
   ],
   "presets": [
     {
-      "name": "Lushi risk reversal"
+      "name": "Runwell risk reversal"
     }
   ]
 }

package/modules/shipping-bar/sections/runwell-shipping-bar.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi free-shipping announcement bar. Sits at the very top of every
+  Runwell free-shipping announcement bar. Sits at the very top of every
   page. Reads cart total and shows a progress message + bar.
 {%- endcomment -%}
 
@@ -40,7 +40,7 @@
 
 {% schema %}
 {
-  "name": "Lushi shipping bar",
+  "name": "Runwell shipping bar",
   "tag": "aside",
   "class": "section-runwell-shipping-bar",
   "enabled_on": {
@@ -88,7 +88,7 @@
   ],
   "presets": [
     {
-      "name": "Lushi shipping bar"
+      "name": "Runwell shipping bar"
     }
   ]
 }

package/modules/sticky-atc/sections/runwell-pdp-sticky.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi sticky add-to-cart for PDP. Slides up from the bottom on scroll
+  Runwell sticky add-to-cart for PDP. Slides up from the bottom on scroll
   past the main buy button, hides again when buy area returns to view.
   Mobile-first; on desktop reveals only after a meaningful scroll depth.
 {%- endcomment -%}
@@ -68,12 +68,12 @@
 
 {% schema %}
 {
-  "name": "Lushi sticky ATC",
+  "name": "Runwell sticky ATC",
   "tag": "section",
   "class": "section-runwell-sticky-atc",
   "settings": [],
   "presets": [
-    { "name": "Lushi sticky ATC" }
+    { "name": "Runwell sticky ATC" }
   ]
 }
 {% endschema %}

package/modules/testimonials/variants/grid-quotes/sections/runwell-testimonials.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi testimonials / UGC strip. Three-up grid of customer quotes with
+  Runwell testimonials / UGC strip. Three-up grid of customer quotes with
   source name + product/lifestyle context. CRO tips 6, 8, 9: social proof
   scattered across the site, unique angles, customer voices.
 {%- endcomment -%}
@@ -44,7 +44,7 @@
 
 {% schema %}
 {
-  "name": "Lushi testimonials",
+  "name": "Runwell testimonials",
   "tag": "section",
   "class": "section-runwell-testimonials",
   "settings": [
@@ -75,7 +75,7 @@
   "max_blocks": 6,
   "presets": [
     {
-      "name": "Lushi testimonials",
+      "name": "Runwell testimonials",
       "blocks": [
         { "type": "quote", "settings": { "quote": "First magnesium I have actually felt working. Read the journal post twice before ordering and now I get why they only carry the glycinate form.", "author": "Margaux, Brooklyn", "context": "Daily Magnesium Glycinate", "rating": "5" } },
         { "type": "quote", "settings": { "quote": "I have tried four collagen brands. This one mixes clean in cold coffee and does not have that fishy aftertaste I gave up trying to mask.", "author": "Priya, Austin", "context": "Marine Collagen Peptides", "rating": "5" } },

package/modules/trust-badges/sections/runwell-trust-badges.liquid

@@ -1,5 +1,5 @@
 {%- comment -%}
-  Lushi trust badges row. Drops on PDP under the buy form (or on cart,
+  Runwell trust badges row. Drops on PDP under the buy form (or on cart,
   collection, or homepage). Renders 3 to 6 trust signals: secure
   checkout, returns, shipping, payment logos. Per Blueprint §3.4 and
   CRO §5.3 (foundational trust signals).
@@ -34,7 +34,7 @@
 
 {% schema %}
 {
-  "name": "Lushi trust badges",
+  "name": "Runwell trust badges",
   "tag": "section",
   "class": "section-runwell-trust-badges",
   "settings": [
@@ -80,11 +80,11 @@
   "max_blocks": 6,
   "presets": [
     {
-      "name": "Lushi trust badges",
+      "name": "Runwell trust badges",
       "blocks": [
         { "type": "badge", "settings": { "icon": "✓", "title": "Free shipping over $75", "body": "On all US orders" } },
         { "type": "badge", "settings": { "icon": "↺", "title": "30-day returns", "body": "No-hassle satisfaction promise" } },
-        { "type": "badge", "settings": { "icon": "★", "title": "Editorially curated", "body": "Every product on Lushi clears 4 checks" } },
+        { "type": "badge", "settings": { "icon": "★", "title": "Editorially curated", "body": "Every product clears 4 checks" } },
         { "type": "badge", "settings": { "icon": "⊕", "title": "Secure checkout", "body": "Encrypted at every step" } }
       ]
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runwell/shopify-toolkit",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Reusable Shopify theme modules from Runwell. Replaces typically app-driven features (reviews, wishlist, urgency, FAQ, post-purchase upsell, exit popups, free-ship progress, sticky ATC, testimonials, badges, bundles) with native Liquid + JS + CSS that ship across multiple client themes via a config-driven sync CLI.",
   "type": "module",
   "main": "lib/index.js",