@runwell/shopify-toolkit 0.3.0 → 0.4.1

package/lib/template.js

@@ -21,7 +21,8 @@ export function interpolate(source, vars) {
   let working = source;
 
   // Second pass: substitute {{config.X}} and {{brand.Y}} and {{client.Z}}
-  working = working.replace(/\{\{\s*([a-zA-Z][a-zA-Z0-9_.]*)\s*\}\}/g, (match, key) => {
+  // Keys can include hyphens (e.g. brand.rain-forrest) and dots for nesting.
+  working = working.replace(/\{\{\s*([a-zA-Z][a-zA-Z0-9_.\-]*)\s*\}\}/g, (match, key) => {
     // If the key starts with a Liquid keyword, leave it alone (it is Shopify Liquid)
     const liquidKeywords = new Set([
       'product', 'collection', 'cart', 'customer', 'shop', 'request',

package/modules/INDEX.md

@@ -0,0 +1,288 @@
+# Runwell Shopify Toolkit: module index
+
+Auto-generated by `scripts/generate-index.mjs`. Do not edit by hand.
+Skills (shopify-storefront, shopify-cro, shopify-cli-ops, shopify-admin-browser) grep this file before writing custom Liquid.
+
+Total modules: 31.
+
+## By category
+
+- **catalog**: bundle-builder, quantity-breaks, subscriptions
+- **conversion**: cart-cross-sell, cart-freeship-progress, cart-usps, exit-intent, gift-with-purchase, post-purchase-upsell, quick-view, risk-reversal, shipping-bar, sticky-atc
+- **customer**: loyalty-tiers, wishlist
+- **pdp**: comparison-table, delivery-estimate, inventory-urgency, pdp-ingredients, pdp-journal-link, pdp-trust-checks, recently-viewed
+- **social-proof**: press-bar, product-badges, reviews, testimonials, trust-badges
+- **storefront**: editorial-block, editorial-hero, faq, how-it-works
+
+## Modules
+
+| Name | Category | Replaces | Files | Config keys | Variants | Admin steps |
+|---|---|---|---|---|---|---|
+| `bundle-builder` | catalog | BYOB-style bundle apps | sections:1 assets:1 | heading, sale_prefix, show_rating, rating_score, rating_count, show_trust_badges, trust_1, trust_2, trust_3, fomo_mode, fomo_cycle_days, fomo_stock_count | (none) | (none) |
+| `cart-cross-sell` | conversion | Rebuy / OneClickUpsell pre-purchase upsell | snippets:1 | eyebrow, cta_label | (none) | (none) |
+| `cart-freeship-progress` | conversion | Bold Free Shipping Manager and similar app features | snippets:1 | threshold_cents, away_text, unlocked_message | (none) | (none) |
+| `cart-usps` | conversion | (native build) | snippets:1 | icon, usp_1, usp_2, usp_3 | (none) | (none) |
+| `comparison-table` | pdp | app-driven comparison widgets |  | eyebrow, heading, lede, background_color, text_color | feature-columns, feature-rows | (none) |
+| `delivery-estimate` | pdp | (native build) | snippets:1 | (none) | (none) | (none) |
+| `editorial-block` | storefront | (native build) | sections:1 | eyebrow, heading, lede, background_color, text_color | (none) | (none) |
+| `editorial-hero` | storefront | (native build) | sections:1 | eyebrow, heading, subheading, video_url, poster_image, min_height, button_label_primary, button_link_primary, button_label_secondary, button_link_secondary | (none) | (none) |
+| `exit-intent` | conversion | (native build) | sections:1 assets:1 | eyebrow, heading, lede | (none) | (none) |
+| `faq` | storefront | (native build) | sections:1 | eyebrow, heading, background_color, text_color | (none) | (none) |
+| `gift-with-purchase` | conversion | (native build) | snippets:1 assets:1 | threshold_cents, gift_handle, unlocked_message, locked_message_suffix | (none) | create-gift-product + create-gift-discount |
+| `how-it-works` | storefront | (native build) | sections:1 | eyebrow, heading, lede, image, asset_filename, background_color, text_color, cta_label, cta_link | (none) | (none) |
+| `inventory-urgency` | pdp | (native build) | snippets:1 | (none) | (none) | (none) |
+| `loyalty-tiers` | customer | (native build) | sections:1 | tier_0_name, tier_1_name, tier_1_threshold, tier_1_perk_pct, tier_2_name, tier_2_threshold, tier_2_perk_pct | (none) | create-tier-tags-and-flows + create-tier-discounts + add-tier-card-to-account |
+| `pdp-ingredients` | pdp | (native build) | sections:1 | eyebrow, heading, lede, background_color, text_color | (none) | (none) |
+| `pdp-journal-link` | pdp | (native build) | sections:1 | eyebrow, article, background_color, text_color, fallback_title, fallback_body, fallback_link_label, fallback_link_url | (none) | (none) |
+| `pdp-trust-checks` | pdp | (native build) | sections:1 | eyebrow, heading, lede, background_color, text_color, link_label, link_url | (none) | (none) |
+| `post-purchase-upsell` | conversion | Reconvert / OneClickUpsell / AfterSell display layer | assets:2 | discount_code, discount_label, max_items, heading, eyebrow, lede, cross_category_logic | (none) | create-discount + paste-bootstrap |
+| `press-bar` | social-proof | (native build) | sections:1 | eyebrow, background_color, text_color | (none) | (none) |
+| `product-badges` | social-proof | (native build) | snippets:1 | label_best_seller, label_new, label_editor_pick | (none) | (none) |
+| `quantity-breaks` | catalog | (native build) | snippets:1 | eyebrow, fineprint | (none) | define-breaks-metafield + set-product-breaks + create-discount-function |
+| `quick-view` | conversion | (native build) | snippets:2 assets:1 | (none) | (none) | (none) |
+| `recently-viewed` | pdp | (native build) | sections:1 assets:1 | eyebrow, heading, background_color | (none) | (none) |
+| `reviews` | social-proof | (native build) | sections:1 | heading | (none) | (none) |
+| `risk-reversal` | conversion | (native build) | sections:1 | icon, heading, body, link_label, link_url, background_color, text_color | (none) | (none) |
+| `shipping-bar` | conversion | (native build) | sections:1 | threshold_cents, message_below, message_qualified, message_default, background_color, text_color | (none) | (none) |
+| `sticky-atc` | conversion | Sticky Add To Cart Booster Pro and similar | sections:1 assets:1 | (none) | (none) | (none) |
+| `subscriptions` | catalog | Recharge / Bold Subscriptions / Appstle for the storefront display layer; subscription management still uses Shopify's native customer account | snippets:1 | one_time_label, subscribe_label, fineprint | (none) | install-shopify-subscriptions + create-selling-plan-group + enable-customer-account-tab |
+| `testimonials` | social-proof | (native build) | sections:1 | eyebrow, heading, background_color, text_color | (none) | (none) |
+| `trust-badges` | social-proof | (native build) | sections:1 | background_color, text_color | (none) | (none) |
+| `wishlist` | customer | Wishlist Plus, Wishlist King, Globo Wishlist | sections:1 snippets:1 assets:1 templates:1 | max_items | (none) | create-wishlist-page |
+
+## Descriptions
+
+### bundle-builder
+
+- Category: catalog
+- Replaces: BYOB-style bundle apps
+- What: Build-your-own-bundle PDP section.
+- Files: sections:1 assets:1
+- Config: heading, sale_prefix, show_rating, rating_score, rating_count, show_trust_badges, trust_1, trust_2, trust_3, fomo_mode, fomo_cycle_days, fomo_stock_count
+
+### cart-cross-sell
+
+- Category: conversion
+- Replaces: Rebuy / OneClickUpsell pre-purchase upsell
+- What: Cart drawer cross-sell card.
+- Files: snippets:1
+- Config: eyebrow, cta_label
+
+### cart-freeship-progress
+
+- Category: conversion
+- Replaces: Bold Free Shipping Manager and similar app features
+- What: Cart drawer free-shipping progress bar.
+- Files: snippets:1
+- Config: threshold_cents, away_text, unlocked_message
+
+### cart-usps
+
+- Category: conversion
+- What: Three brand promises listed at the bottom of the cart drawer.
+- Files: snippets:1
+- Config: icon, usp_1, usp_2, usp_3
+
+### comparison-table
+
+- Category: pdp
+- Replaces: app-driven comparison widgets
+- What: Comparison table section.
+- Config: eyebrow, heading, lede, background_color, text_color
+- Variants: feature-columns, feature-rows
+
+### delivery-estimate
+
+- Category: pdp
+- What: delivery-estimate module migrated from Lushi.
+- Files: snippets:1
+
+### editorial-block
+
+- Category: storefront
+- What: Lushi editorial block module migrated from Lushi.
+- Files: sections:1
+- Config: eyebrow, heading, lede, background_color, text_color
+
+### editorial-hero
+
+- Category: storefront
+- What: Lushi video hero module migrated from Lushi.
+- Files: sections:1
+- Config: eyebrow, heading, subheading, video_url, poster_image, min_height, button_label_primary, button_link_primary, button_label_secondary, button_link_secondary
+
+### exit-intent
+
+- Category: conversion
+- What: Lushi exit popup module migrated from Lushi.
+- Files: sections:1 assets:1
+- Config: eyebrow, heading, lede
+
+### faq
+
+- Category: storefront
+- What: Lushi FAQ module migrated from Lushi.
+- Files: sections:1
+- Config: eyebrow, heading, background_color, text_color
+
+### gift-with-purchase
+
+- Category: conversion
+- What: Auto-add a gift product to the cart when total clears a threshold.
+- Files: snippets:1 assets:1
+- Config: threshold_cents, gift_handle, unlocked_message, locked_message_suffix
+- Admin steps: create-gift-product + create-gift-discount
+
+### how-it-works
+
+- Category: storefront
+- What: Lushi how it works module migrated from Lushi.
+- Files: sections:1
+- Config: eyebrow, heading, lede, image, asset_filename, background_color, text_color, cta_label, cta_link
+
+### inventory-urgency
+
+- Category: pdp
+- What: inventory-urgency module migrated from Lushi.
+- Files: snippets:1
+
+### loyalty-tiers
+
+- Category: customer
+- What: Lifetime-spend tier card on the customer account page.
+- Files: sections:1
+- Config: tier_0_name, tier_1_name, tier_1_threshold, tier_1_perk_pct, tier_2_name, tier_2_threshold, tier_2_perk_pct
+- Admin steps: create-tier-tags-and-flows + create-tier-discounts + add-tier-card-to-account
+
+### pdp-ingredients
+
+- Category: pdp
+- What: Lushi ingredients module migrated from Lushi.
+- Files: sections:1
+- Config: eyebrow, heading, lede, background_color, text_color
+
+### pdp-journal-link
+
+- Category: pdp
+- What: Lushi PDP journal link module migrated from Lushi.
+- Files: sections:1
+- Config: eyebrow, article, background_color, text_color, fallback_title, fallback_body, fallback_link_label, fallback_link_url
+
+### pdp-trust-checks
+
+- Category: pdp
+- What: Lushi PDP trust module migrated from Lushi.
+- Files: sections:1
+- Config: eyebrow, heading, lede, background_color, text_color, link_label, link_url
+
+### post-purchase-upsell
+
+- Category: conversion
+- Replaces: Reconvert / OneClickUpsell / AfterSell display layer
+- What: Order status page upsell with auto-applied discount on click-through.
+- Files: assets:2
+- Config: discount_code, discount_label, max_items, heading, eyebrow, lede, cross_category_logic
+- Admin steps: create-discount + paste-bootstrap
+
+### press-bar
+
+- Category: social-proof
+- What: Lushi press bar module migrated from Lushi.
+- Files: sections:1
+- Config: eyebrow, background_color, text_color
+
+### product-badges
+
+- Category: social-proof
+- What: Tag-driven badges on product cards (Best seller, New, Editor's pick).
+- Files: snippets:1
+- Config: label_best_seller, label_new, label_editor_pick
+
+### quantity-breaks
+
+- Category: catalog
+- What: Tiered quantity-discount display on the PDP.
+- Files: snippets:1
+- Config: eyebrow, fineprint
+- Admin steps: define-breaks-metafield + set-product-breaks + create-discount-function
+
+### quick-view
+
+- Category: conversion
+- What: Modal product quick-view triggered from product cards.
+- Files: snippets:2 assets:1
+
+### recently-viewed
+
+- Category: pdp
+- What: Lushi recently viewed module migrated from Lushi.
+- Files: sections:1 assets:1
+- Config: eyebrow, heading, background_color
+
+### reviews
+
+- Category: social-proof
+- What: Lushi PDP reviews module migrated from Lushi.
+- Files: sections:1
+- Config: heading
+
+### risk-reversal
+
+- Category: conversion
+- What: Lushi risk reversal module migrated from Lushi.
+- Files: sections:1
+- Config: icon, heading, body, link_label, link_url, background_color, text_color
+
+### shipping-bar
+
+- Category: conversion
+- What: Lushi shipping bar module migrated from Lushi.
+- Files: sections:1
+- Config: threshold_cents, message_below, message_qualified, message_default, background_color, text_color
+
+### sticky-atc
+
+- Category: conversion
+- Replaces: Sticky Add To Cart Booster Pro and similar
+- What: Sticky add-to-cart bar that slides up from the bottom on PDP after the buy area scrolls out of view.
+- Files: sections:1 assets:1
+
+### subscriptions
+
+- Category: catalog
+- Replaces: Recharge / Bold Subscriptions / Appstle for the storefront display layer; subscription management still uses Shopify's native customer account
+- What: Brand-styled subscribe-and-save picker that wraps Shopify's native Selling Plan API.
+- Files: snippets:1
+- Config: one_time_label, subscribe_label, fineprint
+- Admin steps: install-shopify-subscriptions + create-selling-plan-group + enable-customer-account-tab
+
+### testimonials
+
+- Category: social-proof
+- What: Lushi testimonials module migrated from Lushi.
+- Files: sections:1
+- Config: eyebrow, heading, background_color, text_color
+
+### trust-badges
+
+- Category: social-proof
+- What: Lushi trust badges module migrated from Lushi.
+- Files: sections:1
+- Config: background_color, text_color
+
+### wishlist
+
+- Category: customer
+- Replaces: Wishlist Plus, Wishlist King, Globo Wishlist
+- What: Native wishlist using localStorage.
+- Files: sections:1 snippets:1 assets:1 templates:1
+- Config: max_items
+- Admin steps: create-wishlist-page
+
+## How a skill should use this
+
+1. Grep this file for keywords from the user request (e.g. "free shipping", "exit popup", "bundle").
+2. If a row matches, run `node ~/Documents/Code/runwell-shopify-toolkit/bin/runwell-shopify add <module-name>` from the client theme directory.
+3. Run `runwell-shopify sync` to copy files into the theme.
+4. If the module has admin steps, hand them to shopify-admin-browser to drive merchant clicks.
+5. Push: `shopify theme push` from the client theme directory.

package/modules/comparison-table/module.json

@@ -1,50 +1,39 @@
 {
   "name": "comparison-table",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "category": "pdp",
-  "description": "Lushi comparison table module migrated from Lushi.",
-  "files": {
-    "sections": [
-      "sections/runwell-comparison-table.liquid"
-    ]
-  },
+  "description": "Comparison table section. Two visual treatments: feature-columns (default) renders columns as Theme Editor blocks with a single textarea of pipe-delimited rows; feature-rows renders one Theme Editor block per comparison row in a 'us vs them' shape with two fixed brand columns. Replaces app-driven comparison widgets.",
+  "default_variant": "feature-columns",
   "config": {
     "schema": {
-      "eyebrow": {
-        "type": "string",
-        "default": "Compared",
-        "label": "Eyebrow"
-      },
-      "heading": {
-        "type": "string",
-        "default": "How it stacks up.",
-        "label": "Heading"
-      },
-      "lede": {
-        "type": "string",
-        "default": "We do not stock everything; here is what makes this one earn the spot.",
-        "label": "Lede"
-      },
-      "row_label_header": {
-        "type": "string",
-        "default": "What you get",
-        "label": "Row label header"
-      },
-      "rows": {
-        "type": "string",
-        "default": "Bioavailable form|yes|no|no\nDose matches research|yes|no|no\nThird-party tested|yes|yes|no\nClean ingredient deck|yes|no|no\nTransparent sourcing|yes|no|yes",
-        "label": "Rows"
+      "eyebrow": { "type": "string", "default": "Compared", "label": "Eyebrow" },
+      "heading": { "type": "string", "default": "How it stacks up.", "label": "Heading" },
+      "lede": { "type": "string", "default": "We do not stock everything; here is what makes this one earn the spot.", "label": "Lede" },
+      "background_color": { "type": "string", "default": "#F5F0EE", "label": "Background color" },
+      "text_color": { "type": "string", "default": "#0B3D38", "label": "Text color" }
+    }
+  },
+  "variants": {
+    "feature-columns": {
+      "description": "Theme Editor blocks are columns (e.g. Lushi pick / Drugstore / Hype brand). Rows come from a textarea (pipe-delimited). Best when comparing many products across the same attributes.",
+      "files": {
+        "sections": ["variants/feature-columns/sections/runwell-comparison-table.liquid"]
       },
-      "background_color": {
-        "type": "string",
-        "default": "#F5F0EE",
-        "label": "Background color"
+      "config_extra": {
+        "row_label_header": { "type": "string", "default": "What you get", "label": "Row label header" },
+        "rows": { "type": "string", "default": "Bioavailable form|yes|no|no\nDose matches research|yes|no|no\nThird-party tested|yes|yes|no\nClean ingredient deck|yes|no|no\nTransparent sourcing|yes|no|yes", "label": "Rows (pipe-delimited)" }
+      }
+    },
+    "feature-rows": {
+      "description": "Theme Editor blocks are rows (one per feature). Two fixed columns: your brand vs one competitor. Best for 'us vs them' positioning on PDP or landing pages.",
+      "files": {
+        "sections": ["variants/feature-rows/sections/runwell-comparison-table.liquid"]
       },
-      "text_color": {
-        "type": "string",
-        "default": "#0B3D38",
-        "label": "Text color"
+      "config_extra": {
+        "feature_label": { "type": "string", "default": "Feature", "label": "Feature column label" },
+        "brand_name": { "type": "string", "default": "Us", "label": "Your brand name" },
+        "competitor_name": { "type": "string", "default": "Traditional", "label": "Competitor name" }
       }
     }
   }
-}
+}

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

@@ -0,0 +1,143 @@
+{%- comment -%}
+  Comparison table, feature-rows variant. Each Theme Editor block is one
+  comparison row (feature + ours + theirs). Use when the brand wants a
+  "us vs them" pattern with a small fixed competitor set.
+  Original shape ported from Lusha (guabrasha-store/sections/comparison-table.liquid).
+{%- endcomment -%}
+
+<section
+  class="runwell-comparison runwell-comparison--feature-rows"
+  style="background: {{ section.settings.background_color }}; color: {{ section.settings.text_color }};"
+>
+  <div style="max-width: 1200px; margin: 0 auto; padding: clamp(3rem, 6vw, 5rem) 6vw;">
+    {%- if section.settings.eyebrow != blank -%}
+      <div style="font-family: var(--font-body-family); font-size: 0.78rem; font-weight: 700; letter-spacing: 0.2em; text-transform: uppercase; opacity: 0.65; margin-bottom: 0.6rem; text-align: center;">
+        {{ section.settings.eyebrow }}
+      </div>
+    {%- endif -%}
+
+    {%- if section.settings.heading != blank -%}
+      <h2 style="font-family: var(--font-heading-family); font-style: italic; font-weight: 400; font-size: clamp(1.8rem, 3.2vw, 2.6rem); line-height: 1.1; margin: 0 auto 1rem; max-width: 24ch; text-align: center;">
+        {{ section.settings.heading }}
+      </h2>
+    {%- endif -%}
+
+    {%- if section.settings.lede != blank -%}
+      <p style="font-family: var(--font-body-family); font-size: 1rem; line-height: 1.65; max-width: 60ch; opacity: 0.85; margin: 0 auto 2rem; text-align: center;">
+        {{ section.settings.lede }}
+      </p>
+    {%- endif -%}
+
+    {%- if section.blocks.size > 0 -%}
+      <div style="overflow-x: auto;">
+        <table style="width: 100%; border-collapse: collapse; min-width: 520px; font-family: var(--font-body-family); font-size: 0.95rem;">
+          <thead>
+            <tr>
+              <th style="text-align: left; padding: 0.9rem 1rem 0.9rem 0; font-family: var(--font-body-family); font-size: 0.72rem; font-weight: 700; letter-spacing: 0.18em; text-transform: uppercase; opacity: 0.6; vertical-align: bottom; border-bottom: 2px solid currentColor;">
+                {{ section.settings.feature_label }}
+              </th>
+              <th style="text-align: center; padding: 0.9rem 1rem; vertical-align: bottom; border-bottom: 2px solid currentColor;">
+                <div style="font-family: var(--font-heading-family); font-style: italic; font-weight: 400; font-size: 1.15rem; line-height: 1.2;">
+                  {{ section.settings.brand_name }}
+                </div>
+              </th>
+              <th style="text-align: center; padding: 0.9rem 1rem; vertical-align: bottom; border-bottom: 2px solid currentColor;">
+                <div style="font-family: var(--font-heading-family); font-style: italic; font-weight: 400; font-size: 1.15rem; line-height: 1.2; opacity: 0.7;">
+                  {{ section.settings.competitor_name }}
+                </div>
+              </th>
+            </tr>
+          </thead>
+          <tbody>
+            {%- for block in section.blocks -%}
+              <tr {{ block.shopify_attributes }}>
+                <td style="padding: 0.9rem 1rem 0.9rem 0; vertical-align: top; border-bottom: 1px solid rgba(0,0,0,0.08); font-weight: 600;">
+                  {{ block.settings.feature }}
+                </td>
+                <td style="padding: 0.9rem 1rem; vertical-align: top; border-bottom: 1px solid rgba(0,0,0,0.08); text-align: center;">
+                  {%- if block.settings.ours == 'yes' -%}
+                    <span style="display: inline-block; min-width: 1.6rem; font-weight: 700; color: var(--runwell-rain-forrest, currentColor);">&check;</span>
+                  {%- elsif block.settings.ours == 'no' -%}
+                    <span style="display: inline-block; min-width: 1.6rem; opacity: 0.4;">&times;</span>
+                  {%- else -%}
+                    <span style="opacity: 0.92;">{{ block.settings.ours_text }}</span>
+                  {%- endif -%}
+                </td>
+                <td style="padding: 0.9rem 1rem; vertical-align: top; border-bottom: 1px solid rgba(0,0,0,0.08); text-align: center;">
+                  {%- if block.settings.theirs == 'yes' -%}
+                    <span style="display: inline-block; min-width: 1.6rem; font-weight: 700; opacity: 0.6;">&check;</span>
+                  {%- elsif block.settings.theirs == 'no' -%}
+                    <span style="display: inline-block; min-width: 1.6rem; opacity: 0.4;">&times;</span>
+                  {%- else -%}
+                    <span style="opacity: 0.7;">{{ block.settings.theirs_text }}</span>
+                  {%- endif -%}
+                </td>
+              </tr>
+            {%- endfor -%}
+          </tbody>
+        </table>
+      </div>
+    {%- endif -%}
+  </div>
+</section>
+
+{% schema %}
+{
+  "name": "Runwell comparison (rows)",
+  "tag": "section",
+  "class": "section-runwell-comparison-rows",
+  "settings": [
+    { "type": "text", "id": "eyebrow", "label": "Eyebrow", "default": "Compared" },
+    { "type": "text", "id": "heading", "label": "Heading", "default": "How it stacks up." },
+    { "type": "textarea", "id": "lede", "label": "Lede" },
+    { "type": "text", "id": "feature_label", "label": "Feature column label", "default": "Feature" },
+    { "type": "text", "id": "brand_name", "label": "Your brand name", "default": "Us" },
+    { "type": "text", "id": "competitor_name", "label": "Competitor name", "default": "Traditional" },
+    { "type": "color", "id": "background_color", "label": "Background", "default": "#F5F0EE" },
+    { "type": "color", "id": "text_color", "label": "Text", "default": "#0B3D38" }
+  ],
+  "blocks": [
+    {
+      "type": "row",
+      "name": "Comparison row",
+      "settings": [
+        { "type": "text", "id": "feature", "label": "Feature" },
+        {
+          "type": "select",
+          "id": "ours",
+          "label": "Your brand",
+          "options": [
+            { "value": "yes", "label": "Yes" },
+            { "value": "no", "label": "No" },
+            { "value": "custom", "label": "Custom text" }
+          ],
+          "default": "yes"
+        },
+        { "type": "text", "id": "ours_text", "label": "Custom text (yours)" },
+        {
+          "type": "select",
+          "id": "theirs",
+          "label": "Competitor",
+          "options": [
+            { "value": "yes", "label": "Yes" },
+            { "value": "no", "label": "No" },
+            { "value": "custom", "label": "Custom text" }
+          ],
+          "default": "no"
+        },
+        { "type": "text", "id": "theirs_text", "label": "Custom text (theirs)" }
+      ]
+    }
+  ],
+  "presets": [
+    {
+      "name": "Runwell comparison (rows)",
+      "blocks": [
+        { "type": "row", "settings": { "feature": "Bioavailable form", "ours": "yes", "theirs": "no" } },
+        { "type": "row", "settings": { "feature": "Third-party tested", "ours": "yes", "theirs": "no" } },
+        { "type": "row", "settings": { "feature": "Transparent sourcing", "ours": "yes", "theirs": "no" } }
+      ]
+    }
+  ]
+}
+{% endschema %}

package/modules/sticky-atc/assets/runwell-sticky-atc.css

@@ -0,0 +1,117 @@
+/* Runwell sticky add-to-cart bar.
+   Slides up from bottom on scroll past the buy area; hides when the
+   main buy button returns to view (driven by IntersectionObserver in
+   the section template).
+*/
+
+.runwell-sticky-atc {
+  position: fixed;
+  inset: auto 0 0 0;
+  z-index: 60;
+  background: #FFFFFF;
+  border-top: 1px solid rgba(0, 0, 0, 0.08);
+  box-shadow: 0 -4px 16px rgba(0, 0, 0, 0.06);
+  transform: translateY(100%);
+  transition: transform 0.25s ease, opacity 0.25s ease;
+  opacity: 0;
+  visibility: hidden;
+}
+
+.runwell-sticky-atc[aria-hidden='false'] {
+  transform: translateY(0);
+  opacity: 1;
+  visibility: visible;
+}
+
+.runwell-sticky-atc__inner {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  max-width: 1200px;
+  margin: 0 auto;
+  padding: 0.75rem 1.25rem;
+}
+
+.runwell-sticky-atc__product {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  min-width: 0;
+}
+
+.runwell-sticky-atc__thumb {
+  width: 40px;
+  height: 40px;
+  border-radius: 4px;
+  object-fit: cover;
+  flex-shrink: 0;
+}
+
+.runwell-sticky-atc__meta {
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+}
+
+.runwell-sticky-atc__title {
+  font-family: var(--font-heading-family, serif);
+  font-style: italic;
+  font-size: 0.95rem;
+  font-weight: 400;
+  line-height: 1.2;
+  color: var(--runwell-primary, #1A1A1A);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.runwell-sticky-atc__price {
+  font-family: var(--font-body-family, sans-serif);
+  font-size: 0.85rem;
+  font-weight: 500;
+  color: var(--runwell-primary, #1A1A1A);
+  opacity: 0.8;
+}
+
+.runwell-sticky-atc__form {
+  flex-shrink: 0;
+  margin: 0;
+}
+
+.runwell-sticky-atc__cta {
+  background: var(--runwell-primary, #1A1A1A);
+  color: #FFFFFF;
+  border: none;
+  border-radius: 0;
+  padding: 0.75rem 1.5rem;
+  font-family: var(--font-body-family, sans-serif);
+  font-size: 0.9rem;
+  font-weight: 600;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+  cursor: pointer;
+  transition: opacity 0.15s ease;
+}
+
+.runwell-sticky-atc__cta:hover {
+  opacity: 0.85;
+}
+
+.runwell-sticky-atc__cta:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+@media (max-width: 749px) {
+  .runwell-sticky-atc__inner {
+    padding: 0.6rem 0.9rem;
+  }
+  .runwell-sticky-atc__title {
+    font-size: 0.85rem;
+  }
+  .runwell-sticky-atc__cta {
+    padding: 0.6rem 1.1rem;
+    font-size: 0.8rem;
+  }
+}

package/modules/sticky-atc/module.json

@@ -1,14 +1,17 @@
 {
   "name": "sticky-atc",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "category": "conversion",
-  "description": "Lushi sticky ATC module migrated from Lushi.",
+  "description": "Sticky add-to-cart bar that slides up from the bottom on PDP after the buy area scrolls out of view. Native, no app. Replaces Sticky Add To Cart Booster Pro and similar.",
   "files": {
     "sections": [
       "sections/runwell-pdp-sticky.liquid"
+    ],
+    "assets": [
+      "assets/runwell-sticky-atc.css"
     ]
   },
   "config": {
     "schema": {}
   }
-}
+}

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

@@ -5,6 +5,7 @@
 {%- endcomment -%}
 
 {%- if template == 'product' and product != blank -%}
+{{ 'runwell-sticky-atc.css' | asset_url | stylesheet_tag }}
 <div class="runwell-sticky-atc" data-runwell-sticky aria-hidden="true">
   <div class="runwell-sticky-atc__inner">
     <div class="runwell-sticky-atc__product">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runwell/shopify-toolkit",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "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",