@runwell/shopify-toolkit 0.1.0 → 0.3.0

package/modules/bundle-builder/sections/runwell-bundle-builder.liquid

@@ -0,0 +1,370 @@
+{{ 'runwell-bundle-builder.css' | asset_url | stylesheet_tag }}
+
+<div class="runwell-bundle-builder color-{{ section.settings.color_scheme }} section-{{ section.id }}-padding">
+  <div class="page-width">
+    <div class="runwell-bundle-builder__grid">
+      <div class="runwell-bundle-builder__media">
+        {%- assign gallery_images = section.blocks | where: "type", "gallery_image" -%}
+        {%- if gallery_images.size > 0 -%}
+          <div class="runwell-bundle-builder__slideshow" data-slideshow>
+            {%- for block in gallery_images -%}
+              <div class="runwell-bundle-builder__slide {% if forloop.first %}runwell-bundle-builder__slide--active{% endif %}" data-slide="{{ forloop.index0 }}" {{ block.shopify_attributes }}>
+                {%- if block.settings.image != blank -%}
+                  {{ block.settings.image | image_url: width: 800 | image_tag: class: 'runwell-bundle-builder__img', loading: forloop.first | default: 'eager', sizes: '(min-width: 990px) 50vw, 100vw' }}
+                {%- else -%}
+                  <div class="runwell-bundle-builder__img runwell-bundle-builder__img--placeholder" aria-label="Image placeholder"></div>
+                {%- endif -%}
+              </div>
+            {%- endfor -%}
+          </div>
+          <div class="runwell-bundle-builder__thumbnails" data-thumbnails>
+            {%- for block in gallery_images -%}
+              <button class="runwell-bundle-builder__thumb {% if forloop.first %}runwell-bundle-builder__thumb--active{% endif %}" data-thumb="{{ forloop.index0 }}" aria-label="View image {{ forloop.index }}">
+                {%- if block.settings.image != blank -%}
+                  {{ block.settings.image | image_url: width: 120, height: 120, crop: 'center' | image_tag: loading: 'lazy' }}
+                {%- else -%}
+                  <div class="runwell-bundle-builder__thumb-img runwell-bundle-builder__thumb-img--placeholder" aria-label="Thumbnail placeholder"></div>
+                {%- endif -%}
+              </button>
+            {%- endfor -%}
+          </div>
+        {%- else -%}
+          <div class="runwell-bundle-builder__slideshow runwell-bundle-builder__slideshow--empty" data-slideshow>
+            <div class="runwell-bundle-builder__slide runwell-bundle-builder__slide--active" data-slide="0">
+              {%- if section.settings.product.featured_image != blank -%}
+                {{ section.settings.product.featured_image | image_url: width: 800 | image_tag: class: 'runwell-bundle-builder__img', loading: 'eager', alt: section.settings.product.title }}
+              {%- else -%}
+                <div class="runwell-bundle-builder__img runwell-bundle-builder__img--placeholder" aria-label="Add gallery images via the section editor"></div>
+              {%- endif -%}
+            </div>
+          </div>
+        {%- endif -%}
+      </div>
+
+      <div class="runwell-bundle-builder__info">
+        {% if section.settings.show_rating %}
+          <div class="runwell-bundle-builder__rating">
+            <span class="runwell-bundle-builder__stars">&#9733;&#9733;&#9733;&#9733;&#9733;</span>
+            <span class="runwell-bundle-builder__rating-text">Rated {{ section.settings.rating_score }} ({{ section.settings.rating_count }} Reviews)</span>
+          </div>
+        {% endif %}
+
+        {% if section.settings.product != blank %}
+          <h2 class="runwell-bundle-builder__title h1">{{ section.settings.product.title }}</h2>
+        {% else %}
+          <h2 class="runwell-bundle-builder__title h1">{{ section.settings.heading }}</h2>
+        {% endif %}
+
+        {%- assign fomo_mode = section.settings.fomo_mode | default: 'none' -%}
+        {%- if fomo_mode != 'none' -%}
+          {%- comment -%} Dynamic FOMO deadline computation {%- endcomment -%}
+          {%- assign now_epoch = 'now' | date: '%s' | plus: 0 -%}
+          {%- assign cycle_seconds = section.settings.fomo_cycle_days | times: 86400 -%}
+          {%- assign cycle_position = now_epoch | modulo: cycle_seconds -%}
+          {%- assign remaining_seconds = cycle_seconds | minus: cycle_position -%}
+          {%- assign remaining_days = remaining_seconds | divided_by: 86400 -%}
+          {%- assign end_epoch = now_epoch | plus: remaining_seconds -%}
+          {%- assign end_date = end_epoch | date: '%B %e' -%}
+
+          <div class="runwell-bundle-builder__sale-heading">
+            <span class="runwell-bundle-builder__sale-line"></span>
+            <span class="runwell-bundle-builder__sale-text">
+              {%- if fomo_mode == 'discount' or fomo_mode == 'both' -%}
+                {{ section.settings.sale_prefix }}: Ends {{ end_date }}
+              {%- else -%}
+                {{ section.settings.sale_prefix }}
+              {%- endif -%}
+            </span>
+            <span class="runwell-bundle-builder__sale-line"></span>
+          </div>
+
+          <div class="runwell-bundle-builder__scarcity">
+            <span class="runwell-bundle-builder__scarcity-dot"></span>
+            Only {{ section.settings.fomo_stock_count }} left in stock
+          </div>
+        {%- elsif section.settings.sale_prefix != blank -%}
+          <div class="runwell-bundle-builder__sale-heading">
+            <span class="runwell-bundle-builder__sale-line"></span>
+            <span class="runwell-bundle-builder__sale-text">{{ section.settings.sale_prefix }}</span>
+            <span class="runwell-bundle-builder__sale-line"></span>
+          </div>
+        {%- endif -%}
+
+        <div class="runwell-bundle-builder__options">
+          {%- assign has_popular = false -%}
+          {%- for block in section.blocks -%}
+            {%- if block.type == 'bundle_option' and block.settings.popular -%}
+              {%- assign has_popular = true -%}
+            {%- endif -%}
+          {%- endfor -%}
+          {% for block in section.blocks %}
+            {% if block.type != 'bundle_option' %}{% continue %}{% endif %}
+            {%- assign is_selected = false -%}
+            {%- if has_popular and block.settings.popular -%}
+              {%- assign is_selected = true -%}
+            {%- elsif has_popular == false and forloop.first -%}
+              {%- assign is_selected = true -%}
+            {%- endif -%}
+            <label class="runwell-bundle-builder__option {% if block.settings.popular %}runwell-bundle-builder__option--popular{% endif %} {% if is_selected %}runwell-bundle-builder__option--selected{% endif %}" {{ block.shopify_attributes }}>
+              {% if block.settings.popular %}
+                <span class="runwell-bundle-builder__popular-badge">MOST POPULAR</span>
+              {% endif %}
+              <input type="radio" name="bundle-{{ section.id }}" value="{{ block.id }}" {% if is_selected %}checked{% endif %}>
+              <div class="runwell-bundle-builder__option-radio"></div>
+              <div class="runwell-bundle-builder__option-content">
+                <div class="runwell-bundle-builder__option-header">
+                  <span class="runwell-bundle-builder__option-title">{{ block.settings.title }}</span>
+                  <div class="runwell-bundle-builder__option-pricing">
+                    <span class="runwell-bundle-builder__option-price">${{ block.settings.price }}</span>
+                    {% if block.settings.compare_price != blank %}
+                      <span class="runwell-bundle-builder__option-compare">${{ block.settings.compare_price }}</span>
+                    {% endif %}
+                  </div>
+                </div>
+                <div class="runwell-bundle-builder__option-badges">
+                  {% if block.settings.savings != blank %}
+                    <span class="runwell-bundle-builder__badge runwell-bundle-builder__badge--save">SAVE ${{ block.settings.savings }}</span>
+                  {% endif %}
+                  {% if block.settings.free_shipping %}
+                    <span class="runwell-bundle-builder__badge runwell-bundle-builder__badge--shipping">FREE SHIPPING</span>
+                  {% endif %}
+                </div>
+                {% if block.settings.free_gift_text != blank %}
+                  <div class="runwell-bundle-builder__free-gift">
+                    <span class="runwell-bundle-builder__gift-icon">&#127873;</span>
+                    <span>{{ block.settings.free_gift_text }}</span>
+                  </div>
+                {% endif %}
+              </div>
+            </label>
+          {% endfor %}
+        </div>
+
+        <div class="runwell-bundle-builder__atc-wrap">
+          <button class="runwell-bundle-builder__atc button" type="button" data-atc>
+            <span class="runwell-bundle-builder__atc-text">ADD TO CART</span>
+            <span class="runwell-bundle-builder__atc-loading" style="display:none;">Adding...</span>
+          </button>
+        </div>
+
+        {% if section.settings.show_trust_badges %}
+          <div class="runwell-bundle-builder__trust">
+            <span>&#9989; {{ section.settings.trust_1 }}</span>
+            <span>&#9989; {{ section.settings.trust_2 }}</span>
+            <span>&#9989; {{ section.settings.trust_3 }}</span>
+          </div>
+        {% endif %}
+      </div>
+    </div>
+  </div>
+</div>
+
+<script>
+  /* Bundle option selection */
+  document.querySelectorAll('.runwell-bundle-builder__option').forEach(option => {
+    option.addEventListener('click', function() {
+      this.closest('.runwell-bundle-builder__options').querySelectorAll('.runwell-bundle-builder__option').forEach(o => o.classList.remove('runwell-bundle-builder__option--selected'));
+      this.classList.add('runwell-bundle-builder__option--selected');
+      this.querySelector('input').checked = true;
+    });
+  });
+
+  /* Thumbnail slideshow */
+  document.querySelectorAll('[data-thumbnails]').forEach(container => {
+    container.querySelectorAll('[data-thumb]').forEach(thumb => {
+      thumb.addEventListener('click', function() {
+        const idx = this.dataset.thumb;
+        const section = this.closest('.runwell-bundle-builder');
+        section.querySelectorAll('.runwell-bundle-builder__slide').forEach(s => s.classList.remove('runwell-bundle-builder__slide--active'));
+        section.querySelectorAll('.runwell-bundle-builder__thumb').forEach(t => t.classList.remove('runwell-bundle-builder__thumb--active'));
+        section.querySelector('[data-slide="' + idx + '"]').classList.add('runwell-bundle-builder__slide--active');
+        this.classList.add('runwell-bundle-builder__thumb--active');
+      });
+    });
+  });
+
+  /* Add to Cart (Shopify Ajax API) */
+  document.querySelectorAll('[data-atc]').forEach(btn => {
+    btn.addEventListener('click', function() {
+      const section = this.closest('.runwell-bundle-builder');
+      const selected = section.querySelector('.runwell-bundle-builder__option--selected');
+      if (!selected) return;
+
+      const title = selected.querySelector('.runwell-bundle-builder__option-title');
+      const qtyMatch = title ? title.textContent.match(/^(\d+)x/) : null;
+      const qty = qtyMatch ? parseInt(qtyMatch[1]) : 1;
+
+      const textEl = this.querySelector('.runwell-bundle-builder__atc-text');
+      const loadEl = this.querySelector('.runwell-bundle-builder__atc-loading');
+      textEl.style.display = 'none';
+      loadEl.style.display = 'inline';
+      this.disabled = true;
+
+      fetch('/cart/add.js', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ items: [{ id: {{ section.settings.product.selected_or_first_available_variant.id | default: 0 }}, quantity: qty }] })
+      })
+      .then(r => r.json())
+      .then(() => {
+        textEl.textContent = 'ADDED!';
+        textEl.style.display = 'inline';
+        loadEl.style.display = 'none';
+        setTimeout(() => {
+          textEl.textContent = 'ADD TO CART';
+          this.disabled = false;
+        }, 2000);
+      })
+      .catch(() => {
+        textEl.textContent = 'ADD TO CART';
+        textEl.style.display = 'inline';
+        loadEl.style.display = 'none';
+        this.disabled = false;
+      });
+    });
+  });
+</script>
+
+{% schema %}
+{
+  "name": "Runwell Bundle Builder",
+  "tag": "section",
+  "class": "section-runwell-bundle-builder",
+  "settings": [
+    {
+      "type": "product",
+      "id": "product",
+      "label": "Product"
+    },
+    {
+      "type": "text",
+      "id": "heading",
+      "label": "Heading (fallback)",
+      "default": "Build your bundle"
+    },
+    {
+      "type": "text",
+      "id": "sale_prefix",
+      "label": "Sale heading prefix",
+      "default": "Limited time offer"
+    },
+    {
+      "type": "select",
+      "id": "fomo_mode",
+      "label": "FOMO mode",
+      "options": [
+        { "value": "discount", "label": "Discount deadline" },
+        { "value": "scarcity", "label": "Stock scarcity" },
+        { "value": "both", "label": "Both" },
+        { "value": "none", "label": "None (static heading)" }
+      ],
+      "default": "both"
+    },
+    {
+      "type": "range",
+      "id": "fomo_cycle_days",
+      "label": "FOMO cycle (days)",
+      "min": 7,
+      "max": 90,
+      "step": 1,
+      "default": 30,
+      "unit": "d"
+    },
+    {
+      "type": "range",
+      "id": "fomo_stock_count",
+      "label": "Stock scarcity count",
+      "min": 5,
+      "max": 100,
+      "step": 1,
+      "default": 47,
+      "unit": "qty"
+    },
+    {
+      "type": "checkbox",
+      "id": "show_rating",
+      "label": "Show star rating",
+      "default": true
+    },
+    {
+      "type": "text",
+      "id": "rating_score",
+      "label": "Rating score",
+      "default": "4.8/5"
+    },
+    {
+      "type": "text",
+      "id": "rating_count",
+      "label": "Rating count",
+      "default": "2,400+"
+    },
+    {
+      "type": "checkbox",
+      "id": "show_trust_badges",
+      "label": "Show trust badges",
+      "default": true
+    },
+    { "type": "text", "id": "trust_1", "label": "Trust badge 1", "default": "90-Day Guarantee" },
+    { "type": "text", "id": "trust_2", "label": "Trust badge 2", "default": "Easy Returns" },
+    { "type": "text", "id": "trust_3", "label": "Trust badge 3", "default": "Free Shipping" },
+    {
+      "type": "color_scheme",
+      "id": "color_scheme",
+      "label": "Color scheme",
+      "default": "scheme-1"
+    },
+    {
+      "type": "range",
+      "id": "padding_top",
+      "label": "Top padding",
+      "min": 0, "max": 100, "step": 4, "default": 40, "unit": "px"
+    },
+    {
+      "type": "range",
+      "id": "padding_bottom",
+      "label": "Bottom padding",
+      "min": 0, "max": 100, "step": 4, "default": 40, "unit": "px"
+    }
+  ],
+  "blocks": [
+    {
+      "type": "gallery_image",
+      "name": "Gallery image",
+      "settings": [
+        { "type": "image_picker", "id": "image", "label": "Image" },
+        { "type": "text", "id": "alt", "label": "Alt text", "default": "Product image" }
+      ]
+    },
+    {
+      "type": "bundle_option",
+      "name": "Bundle option",
+      "settings": [
+        { "type": "text", "id": "title", "label": "Title (e.g. \"1x Product\")", "default": "1x Product" },
+        { "type": "text", "id": "price", "label": "Price", "default": "24.99" },
+        { "type": "text", "id": "compare_price", "label": "Compare at price", "default": "49.99" },
+        { "type": "text", "id": "savings", "label": "Savings amount", "default": "25.00" },
+        { "type": "checkbox", "id": "free_shipping", "label": "Free shipping badge", "default": false },
+        { "type": "checkbox", "id": "popular", "label": "Most popular (highlighted)", "default": false },
+        { "type": "text", "id": "free_gift_text", "label": "Free gift text" }
+      ]
+    }
+  ],
+  "presets": [
+    {
+      "name": "Runwell Bundle Builder",
+      "blocks": [
+        { "type": "bundle_option", "settings": { "title": "1x Product", "price": "24.99", "compare_price": "49.99", "savings": "25.00", "free_shipping": false, "popular": false } },
+        { "type": "bundle_option", "settings": { "title": "2x Product", "price": "39.99", "compare_price": "99.98", "savings": "59.99", "free_shipping": true, "popular": true } },
+        { "type": "bundle_option", "settings": { "title": "3x Product", "price": "59.99", "compare_price": "149.97", "savings": "89.98", "free_shipping": true, "popular": false, "free_gift_text": "+ Free gift with purchase" } }
+      ]
+    }
+  ]
+}
+{% endschema %}
+
+<style>
+  .section-{{ section.id }}-padding {
+    padding-top: {{ section.settings.padding_top }}px;
+    padding-bottom: {{ section.settings.padding_bottom }}px;
+  }
+</style>

package/modules/cart-cross-sell/README.md

@@ -0,0 +1,32 @@
+# cart-cross-sell
+
+Cart drawer cross-sell suggestion. Picks the first available product not already in cart and renders a one-click Add card.
+
+## Files
+
+- `snippets/runwell-cart-xsell.liquid`
+
+## How to use
+
+In `snippets/cart-drawer.liquid` body:
+
+```liquid
+{% render 'runwell-cart-xsell' %}
+```
+
+## Config
+
+| Key | Default | Notes |
+|---|---|---|
+| `eyebrow` | `Pairs well with` | Tag above the suggestion |
+| `cta_label` | `Add` | Button label |
+
+## Replaces
+
+Rebuy, One Click Upsell (OCU) pre-purchase display layer.
+
+## Future variants
+
+- `tag-based`: filter to products tagged complementary to cart contents
+- `metafield-curated`: per-product complementary set in `lushi.complements` metafield
+- `recommendations-api`: Shopify `recommendations.json?intent=complementary`

package/modules/cart-cross-sell/module.json

@@ -0,0 +1,15 @@
+{
+  "name": "cart-cross-sell",
+  "version": "0.1.0",
+  "category": "conversion",
+  "description": "Cart drawer cross-sell card. Suggests one related product not yet in cart with one-click Add. Replaces Rebuy / OneClickUpsell pre-purchase upsell.",
+  "files": {
+    "snippets": ["snippets/runwell-cart-xsell.liquid"]
+  },
+  "config": {
+    "schema": {
+      "eyebrow": { "type": "string", "default": "Pairs well with" },
+      "cta_label": { "type": "string", "default": "Add" }
+    }
+  }
+}

package/modules/cart-cross-sell/snippets/runwell-cart-xsell.liquid

@@ -0,0 +1,40 @@
+{%- comment -%}
+  Runwell cart cross-sell. Surfaces the first available product not
+  already in cart. Replaces Rebuy/OneClickUpsell pre-purchase upsell
+  display. Render inside cart-drawer.liquid via:
+  {% render 'runwell-cart-xsell' %}
+{%- endcomment -%}
+
+{%- if cart.item_count > 0 -%}
+  {%- assign cart_handles = cart.items | map: 'handle' -%}
+  {%- assign suggestion = blank -%}
+  {%- for p in collections.all.products -%}
+    {%- unless cart_handles contains p.handle -%}
+      {%- if p.available -%}
+        {%- assign suggestion = p -%}
+        {%- break -%}
+      {%- endif -%}
+    {%- endunless -%}
+  {%- endfor -%}
+  {%- if suggestion != blank -%}
+    <div class="runwell-cart-xsell" data-runwell-xsell>
+      <p class="runwell-cart-xsell__eyebrow">{{config.eyebrow}}</p>
+      <div class="runwell-cart-xsell__row">
+        {%- if suggestion.featured_image -%}
+          <a href="{{ suggestion.url }}" class="runwell-cart-xsell__media" aria-hidden="true" tabindex="-1">
+            <img src="{{ suggestion.featured_image | image_url: width: 120 }}" alt="" width="60" height="60" loading="lazy">
+          </a>
+        {%- endif -%}
+        <div class="runwell-cart-xsell__body">
+          <a href="{{ suggestion.url }}" class="runwell-cart-xsell__title">{{ suggestion.title }}</a>
+          <span class="runwell-cart-xsell__price">{{ suggestion.price | money }}</span>
+        </div>
+        <form action="{{ routes.cart_add_url }}" method="post" enctype="multipart/form-data" class="runwell-cart-xsell__form">
+          <input type="hidden" name="id" value="{{ suggestion.selected_or_first_available_variant.id }}">
+          <input type="hidden" name="quantity" value="1">
+          <button type="submit" class="runwell-cart-xsell__cta">{{config.cta_label}}</button>
+        </form>
+      </div>
+    </div>
+  {%- endif -%}
+{%- endif -%}

package/modules/cart-freeship-progress/README.md

@@ -0,0 +1,29 @@
+# cart-freeship-progress
+
+Cart drawer free-shipping progress bar. Renders dynamic remaining-to-free-ship message + a CSS progress fill that updates with cart total.
+
+## Files
+
+- `snippets/runwell-cart-freeship.liquid`
+
+## How to use
+
+In `snippets/cart-drawer.liquid` (or wherever your cart drawer body is):
+
+```liquid
+{% render 'runwell-cart-freeship' %}
+```
+
+CSS is part of `_shared/css-tokens` + the styles already present in the merchant theme stylesheet (look for `.runwell-freeship` rules in your CSS).
+
+## Config
+
+| Key | Default | Notes |
+|---|---|---|
+| `threshold_cents` | `7500` | Threshold in cents (USD `$75 = 7500`). Adjust for currency. |
+| `away_text` | `away from free shipping.` | Text appended after the dynamic remaining amount |
+| `unlocked_message` | `You unlocked free shipping. <strong>Glow on.</strong>` | HTML shown when cart total clears the threshold |
+
+## Replaces
+
+Bold Free Shipping Manager, similar app features.

package/modules/cart-freeship-progress/module.json

@@ -0,0 +1,16 @@
+{
+  "name": "cart-freeship-progress",
+  "version": "0.1.0",
+  "category": "conversion",
+  "description": "Cart drawer free-shipping progress bar. Shows remaining $$ to free ship + visual progress fill. Replaces Bold Free Shipping Manager and similar app features.",
+  "files": {
+    "snippets": ["snippets/runwell-cart-freeship.liquid"]
+  },
+  "config": {
+    "schema": {
+      "threshold_cents": { "type": "number", "default": 7500, "label": "Free shipping threshold (cents)" },
+      "away_text": { "type": "string", "default": "away from free shipping.", "label": "Text after remaining amount" },
+      "unlocked_message": { "type": "string", "default": "You unlocked free shipping. <strong>Glow on.</strong>", "label": "HTML shown when threshold met" }
+    }
+  }
+}

package/modules/cart-freeship-progress/snippets/runwell-cart-freeship.liquid

@@ -0,0 +1,27 @@
+{%- comment -%}
+  Runwell cart free-shipping progress bar.
+  Renders inside cart-drawer.liquid via {% render 'runwell-cart-freeship' %}.
+  Replaces inline implementations and the freeship-bar feature in apps
+  like Vitals / Bold Free Shipping Manager.
+{%- endcomment -%}
+
+{%- assign runwell_freeship_threshold_cents = {{config.threshold_cents}} -%}
+{%- assign runwell_remaining = runwell_freeship_threshold_cents | minus: cart.total_price -%}
+<div class="runwell-freeship">
+  {%- if cart.item_count > 0 -%}
+    {%- if runwell_remaining > 0 -%}
+      <p class="runwell-freeship__msg">
+        You're <strong>{{ runwell_remaining | money }}</strong> {{config.away_text}}
+      </p>
+    {%- else -%}
+      <p class="runwell-freeship__msg runwell-freeship__msg--unlocked">
+        {{config.unlocked_message}}
+      </p>
+    {%- endif -%}
+    <div class="runwell-freeship__track" aria-hidden="true">
+      {%- assign pct = cart.total_price | times: 100.0 | divided_by: runwell_freeship_threshold_cents -%}
+      {%- if pct > 100 -%}{%- assign pct = 100 -%}{%- endif -%}
+      <div class="runwell-freeship__fill" style="width: {{ pct }}%"></div>
+    </div>
+  {%- endif -%}
+</div>

package/modules/cart-usps/README.md

@@ -0,0 +1,22 @@
+# cart-usps
+
+Three brand promises listed at the bottom of the cart drawer. Reinforces trust at the moment of decision.
+
+## Files
+
+- `snippets/runwell-cart-usps.liquid`
+
+## How to use
+
+```liquid
+{% render 'runwell-cart-usps' %}
+```
+
+## Config
+
+| Key | Default | Notes |
+|---|---|---|
+| `icon` | `✓` | Bullet icon (HTML entity or emoji) |
+| `usp_1` | `30-day satisfaction promise` | First USP |
+| `usp_2` | `Editorially curated, not bulk-stocked` | Second USP |
+| `usp_3` | `Every product paired with a journal post` | Third USP |

package/modules/cart-usps/module.json

@@ -0,0 +1,17 @@
+{
+  "name": "cart-usps",
+  "version": "0.1.0",
+  "category": "conversion",
+  "description": "Three brand promises listed at the bottom of the cart drawer. Native, no app.",
+  "files": {
+    "snippets": ["snippets/runwell-cart-usps.liquid"]
+  },
+  "config": {
+    "schema": {
+      "icon": { "type": "string", "default": "✓", "label": "Bullet icon (HTML entity or emoji)" },
+      "usp_1": { "type": "string", "default": "30-day satisfaction promise" },
+      "usp_2": { "type": "string", "default": "Editorially curated, not bulk-stocked" },
+      "usp_3": { "type": "string", "default": "Every product paired with a journal post" }
+    }
+  }
+}

package/modules/cart-usps/snippets/runwell-cart-usps.liquid

@@ -0,0 +1,11 @@
+{%- comment -%}
+  Runwell cart USPs. Three short bullets at the bottom of the cart
+  drawer reinforcing brand promises. Render via:
+  {% render 'runwell-cart-usps' %}
+{%- endcomment -%}
+
+<ul class="runwell-cart-usps" aria-label="Brand promises">
+  <li><span aria-hidden="true">{{config.icon}}</span> {{config.usp_1}}</li>
+  <li><span aria-hidden="true">{{config.icon}}</span> {{config.usp_2}}</li>
+  <li><span aria-hidden="true">{{config.icon}}</span> {{config.usp_3}}</li>
+</ul>

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

@@ -28,11 +28,11 @@
       height="1080"
       loading="eager"
     >
-  {%- else -%}
-    {%- comment -%} Fallback to bundled v1 imagery so the hero is never blank pre-launch {%- endcomment -%}
+  {%- elsif section.settings.fallback_asset != blank -%}
+    {%- comment -%} Fallback to bundled brand image so the hero is never blank pre-launch {%- endcomment -%}
     <img
       class="runwell-video-hero__video"
-      src="{{ 'runwell-hero-bg.jpg' | asset_url }}"
+      src="{{ section.settings.fallback_asset | asset_url }}"
       alt="{{ section.settings.heading | escape }}"
       width="1920"
       height="1080"
@@ -109,6 +109,12 @@
       "id": "poster_image",
       "label": "Poster image (and fallback)"
     },
+    {
+      "type": "text",
+      "id": "fallback_asset",
+      "label": "Fallback asset filename",
+      "info": "Bundled theme asset filename (e.g. lushi-hero-bg.jpg). Used when video_url and poster_image are blank."
+    },
     {
       "type": "range",
       "id": "min_height",

package/modules/gift-with-purchase/README.md

@@ -0,0 +1,36 @@
+# gift-with-purchase
+
+Auto-add a gift product to the cart when total clears a threshold. Shows progress message before unlock and confirmation after. Combine with a Shopify 100%-off automatic discount on the gift SKU so the line lands free at checkout.
+
+## Files
+
+- `snippets/runwell-gwp.liquid`. Cart-drawer snippet rendering progress + unlock state.
+- `assets/runwell-gwp.js`. Auto-adder. Posts to `/cart/add.js` once when threshold is met and gift is not yet in cart.
+
+## How to use
+
+1. Run admin steps in `module.json`: create the gift product, create the 100% off automatic discount targeting it
+2. Render the snippet in `snippets/cart-drawer.liquid`:
+   ```liquid
+   {% render 'runwell-gwp' %}
+   ```
+3. Sync: `runwell-shopify sync`
+
+## Behaviour
+
+- Cart total below threshold: shows "Spend $X more for [unlocked_message]"
+- Cart total above threshold AND gift not yet in cart: auto-adds gift, shows "[unlocked_message]"
+- Cart total above threshold AND gift in cart: shows "[unlocked_message]" only
+
+## Config
+
+| Key | Default | Notes |
+|---|---|---|
+| `threshold_cents` | `10000` | $100 default. Adjust per AOV. |
+| `gift_handle` | `free-gift` | Product handle for the auto-added gift |
+| `unlocked_message` | `You earned a free gift.` | Shown when threshold met |
+| `locked_message_suffix` | `a free gift.` | Appended to "Spend $X more for..." |
+
+## Replaces
+
+Free Gifts BOGO Plus, Bold Free Gifts, Tada free gift apps.