@runwell/shopify-toolkit 0.1.0

package/modules/pdp-ingredients/README.md

@@ -0,0 +1,17 @@
+# pdp-ingredients
+
+Lushi ingredients. Migrated from Lushi (`sections/lushi-ingredients.liquid`) into the Runwell Shopify Toolkit.
+
+Category: `pdp`
+
+## Files
+
+- `sections/runwell-ingredients.liquid`
+
+## Config
+
+See `module.json` config schema. Defaults match the original Lushi defaults; override per client in `runwell.config.json`.
+
+## Lineage
+
+This module was extracted from the Lushi build (Capital V) and generalised. The original lives at `lushi-shopify/sections/lushi-ingredients.liquid`. The toolkit version uses `runwell-` class prefixes and pulls brand vars from the client config.

package/modules/pdp-ingredients/module.json

@@ -0,0 +1,40 @@
+{
+  "name": "pdp-ingredients",
+  "version": "0.1.0",
+  "category": "pdp",
+  "description": "Lushi ingredients module migrated from Lushi.",
+  "files": {
+    "sections": [
+      "sections/runwell-ingredients.liquid"
+    ]
+  },
+  "config": {
+    "schema": {
+      "eyebrow": {
+        "type": "string",
+        "default": "What's inside",
+        "label": "Eyebrow"
+      },
+      "heading": {
+        "type": "string",
+        "default": "The hero ingredients.",
+        "label": "Heading"
+      },
+      "lede": {
+        "type": "string",
+        "default": "We list the dose for every active. If we used a buzzword ingredient, we'll tell you why.",
+        "label": "Lede"
+      },
+      "background_color": {
+        "type": "string",
+        "default": "#EDE6D8",
+        "label": "Background color"
+      },
+      "text_color": {
+        "type": "string",
+        "default": "#0B3D38",
+        "label": "Text color"
+      }
+    }
+  }
+}

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

@@ -0,0 +1,139 @@
+{%- comment -%}
+  Lushi 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
+  manual blocks as the fallback.
+{%- endcomment -%}
+
+{%- assign ingredients_meta = product.metafields.lushi.ingredients.value -%}
+
+<section
+  class="runwell-ingredients"
+  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;">
+        {{ 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 0 1rem 0; max-width: 22ch;">
+        {{ 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 0 2.5rem 0;">
+        {{ section.settings.lede }}
+      </p>
+    {%- endif -%}
+
+    <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); gap: 1.6rem;">
+      {%- if ingredients_meta != blank -%}
+        {%- for ing in ingredients_meta -%}
+          <div style="border-top: 2px solid currentColor; padding-top: 1rem;">
+            {%- if ing.dose != blank -%}
+              <div style="font-family: var(--font-body-family); font-size: 0.72rem; font-weight: 700; letter-spacing: 0.2em; text-transform: uppercase; opacity: 0.6; margin-bottom: 0.4rem;">
+                {{ ing.dose }}
+              </div>
+            {%- endif -%}
+            <h3 style="font-family: var(--font-heading-family); font-style: italic; font-weight: 400; font-size: 1.3rem; line-height: 1.2; margin: 0 0 0.5rem 0;">
+              {{ ing.name }}
+            </h3>
+            {%- if ing.role != blank -%}
+              <p style="font-family: var(--font-body-family); font-size: 0.92rem; line-height: 1.6; opacity: 0.85; margin: 0;">
+                {{ ing.role }}
+              </p>
+            {%- endif -%}
+          </div>
+        {%- endfor -%}
+      {%- else -%}
+        {%- for block in section.blocks -%}
+          <div {{ block.shopify_attributes }} style="border-top: 2px solid currentColor; padding-top: 1rem;">
+            {%- if block.settings.dose != blank -%}
+              <div style="font-family: var(--font-body-family); font-size: 0.72rem; font-weight: 700; letter-spacing: 0.2em; text-transform: uppercase; opacity: 0.6; margin-bottom: 0.4rem;">
+                {{ block.settings.dose }}
+              </div>
+            {%- endif -%}
+            <h3 style="font-family: var(--font-heading-family); font-style: italic; font-weight: 400; font-size: 1.3rem; line-height: 1.2; margin: 0 0 0.5rem 0;">
+              {{ block.settings.name }}
+            </h3>
+            {%- if block.settings.role != blank -%}
+              <p style="font-family: var(--font-body-family); font-size: 0.92rem; line-height: 1.6; opacity: 0.85; margin: 0;">
+                {{ block.settings.role }}
+              </p>
+            {%- endif -%}
+          </div>
+        {%- endfor -%}
+      {%- endif -%}
+    </div>
+  </div>
+</section>
+
+{% schema %}
+{
+  "name": "Lushi ingredients",
+  "tag": "section",
+  "class": "section-runwell-ingredients",
+  "settings": [
+    {
+      "type": "text",
+      "id": "eyebrow",
+      "label": "Eyebrow",
+      "default": "What's inside"
+    },
+    {
+      "type": "text",
+      "id": "heading",
+      "label": "Heading",
+      "default": "The hero ingredients."
+    },
+    {
+      "type": "textarea",
+      "id": "lede",
+      "label": "Lede",
+      "default": "We list the dose for every active. If we used a buzzword ingredient, we'll tell you why."
+    },
+    {
+      "type": "color",
+      "id": "background_color",
+      "label": "Background color",
+      "default": "#EDE6D8"
+    },
+    {
+      "type": "color",
+      "id": "text_color",
+      "label": "Text color",
+      "default": "#0B3D38"
+    },
+    {
+      "type": "paragraph",
+      "content": "If product.metafields.lushi.ingredients is set, those are used and the blocks below are ignored."
+    }
+  ],
+  "blocks": [
+    {
+      "type": "ingredient",
+      "name": "Ingredient",
+      "settings": [
+        { "type": "text", "id": "name", "label": "Name", "default": "Magnesium glycinate" },
+        { "type": "text", "id": "dose", "label": "Dose", "default": "200mg" },
+        { "type": "textarea", "id": "role", "label": "What it does" }
+      ]
+    }
+  ],
+  "max_blocks": 8,
+  "presets": [
+    {
+      "name": "Lushi 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." } },
+        { "type": "ingredient", "settings": { "name": "Apigenin", "dose": "50mg", "role": "Found in chamomile. Mild anxiolytic effect; supports a quieter pre-sleep mind." } }
+      ]
+    }
+  ]
+}
+{% endschema %}

package/modules/pdp-journal-link/README.md

@@ -0,0 +1,17 @@
+# pdp-journal-link
+
+Lushi PDP journal link. Migrated from Lushi (`sections/lushi-pdp-journal.liquid`) into the Runwell Shopify Toolkit.
+
+Category: `pdp`
+
+## Files
+
+- `sections/runwell-pdp-journal.liquid`
+
+## Config
+
+See `module.json` config schema. Defaults match the original Lushi defaults; override per client in `runwell.config.json`.
+
+## Lineage
+
+This module was extracted from the Lushi build (Capital V) and generalised. The original lives at `lushi-shopify/sections/lushi-pdp-journal.liquid`. The toolkit version uses `runwell-` class prefixes and pulls brand vars from the client config.

package/modules/pdp-journal-link/module.json

@@ -0,0 +1,53 @@
+{
+  "name": "pdp-journal-link",
+  "version": "0.1.0",
+  "category": "pdp",
+  "description": "Lushi PDP journal link module migrated from Lushi.",
+  "files": {
+    "sections": [
+      "sections/runwell-pdp-journal.liquid"
+    ]
+  },
+  "config": {
+    "schema": {
+      "eyebrow": {
+        "type": "string",
+        "default": "From the journal",
+        "label": "Eyebrow"
+      },
+      "article": {
+        "type": "string",
+        "label": "Linked article (override)"
+      },
+      "background_color": {
+        "type": "string",
+        "default": "#0B3D38",
+        "label": "Background color"
+      },
+      "text_color": {
+        "type": "string",
+        "default": "#EDE6D8",
+        "label": "Text color"
+      },
+      "fallback_title": {
+        "type": "string",
+        "default": "Read the full story.",
+        "label": "Fallback title"
+      },
+      "fallback_body": {
+        "type": "string",
+        "default": "Every product on Lushi pairs with a journal article. Browse the full archive to dig deeper.",
+        "label": "Fallback body"
+      },
+      "fallback_link_label": {
+        "type": "string",
+        "default": "Visit the journal",
+        "label": "Fallback link label"
+      },
+      "fallback_link_url": {
+        "type": "string",
+        "label": "Fallback link URL"
+      }
+    }
+  }
+}

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

@@ -0,0 +1,124 @@
+{%- 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.
+{%- endcomment -%}
+
+{%- assign linked_article = product.metafields.lushi.journal_article.value -%}
+{%- if linked_article == blank -%}
+  {%- assign linked_article = section.settings.article -%}
+{%- endif -%}
+
+{%- if linked_article != blank or section.settings.fallback_title != blank -%}
+<section
+  class="runwell-pdp-journal"
+  style="background: {{ section.settings.background_color }}; color: {{ section.settings.text_color }};"
+>
+  <div class="runwell-pdp-journal__inner" style="max-width: 1200px; margin: 0 auto; padding: clamp(3rem, 6vw, 5rem) 6vw; display: grid; grid-template-columns: 1fr; gap: 2rem;">
+    <div style="display: grid; grid-template-columns: minmax(0, 1fr); gap: 2rem; align-items: center;">
+      <div>
+        {%- 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;">
+            {{ section.settings.eyebrow }}
+          </div>
+        {%- endif -%}
+
+        {%- if linked_article != 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 0 0.8rem 0; max-width: 22ch;">
+            {{ linked_article.title }}
+          </h2>
+          <p style="font-family: var(--font-body-family); font-size: 1rem; line-height: 1.65; max-width: 60ch; opacity: 0.85; margin: 0 0 1.4rem 0;">
+            {{ linked_article.excerpt_or_content | strip_html | truncate: 180 }}
+          </p>
+          <a href="{{ linked_article.url }}"
+             style="display: inline-block; padding: 0.85rem 1.4rem; border-radius: 4px; background: {{ section.settings.text_color }}; color: {{ section.settings.background_color }}; font-weight: 700; font-size: 0.85rem; letter-spacing: 0.04em; text-transform: uppercase; text-decoration: none;">
+            Read the journal &rarr;
+          </a>
+        {%- else -%}
+          <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 0 0.8rem 0; max-width: 22ch;">
+            {{ section.settings.fallback_title }}
+          </h2>
+          {%- if section.settings.fallback_body != blank -%}
+            <p style="font-family: var(--font-body-family); font-size: 1rem; line-height: 1.65; max-width: 60ch; opacity: 0.85; margin: 0 0 1.4rem 0;">
+              {{ section.settings.fallback_body }}
+            </p>
+          {%- endif -%}
+          {%- if section.settings.fallback_link_url != blank -%}
+            <a href="{{ section.settings.fallback_link_url }}"
+               style="display: inline-block; padding: 0.85rem 1.4rem; border-radius: 4px; background: {{ section.settings.text_color }}; color: {{ section.settings.background_color }}; font-weight: 700; font-size: 0.85rem; letter-spacing: 0.04em; text-transform: uppercase; text-decoration: none;">
+              {{ section.settings.fallback_link_label | default: 'Read more' }} &rarr;
+            </a>
+          {%- endif -%}
+        {%- endif -%}
+      </div>
+    </div>
+  </div>
+</section>
+{%- endif -%}
+
+{% schema %}
+{
+  "name": "Lushi PDP journal link",
+  "tag": "section",
+  "class": "section-runwell-pdp-journal",
+  "settings": [
+    {
+      "type": "text",
+      "id": "eyebrow",
+      "label": "Eyebrow",
+      "default": "From the journal"
+    },
+    {
+      "type": "article",
+      "id": "article",
+      "label": "Linked article (override)",
+      "info": "Optional. If set, overrides the product's lushi.journal_article metafield."
+    },
+    {
+      "type": "color",
+      "id": "background_color",
+      "label": "Background color",
+      "default": "#0B3D38"
+    },
+    {
+      "type": "color",
+      "id": "text_color",
+      "label": "Text color",
+      "default": "#EDE6D8"
+    },
+    {
+      "type": "header",
+      "content": "Fallback (when no article is set)"
+    },
+    {
+      "type": "text",
+      "id": "fallback_title",
+      "label": "Fallback title",
+      "default": "Read the full story."
+    },
+    {
+      "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."
+    },
+    {
+      "type": "text",
+      "id": "fallback_link_label",
+      "label": "Fallback link label",
+      "default": "Visit the journal"
+    },
+    {
+      "type": "url",
+      "id": "fallback_link_url",
+      "label": "Fallback link URL"
+    }
+  ],
+  "presets": [
+    {
+      "name": "Lushi PDP journal link"
+    }
+  ]
+}
+{% endschema %}

package/modules/pdp-trust-checks/README.md

@@ -0,0 +1,17 @@
+# pdp-trust-checks
+
+Lushi PDP trust. Migrated from Lushi (`sections/lushi-pdp-trust.liquid`) into the Runwell Shopify Toolkit.
+
+Category: `pdp`
+
+## Files
+
+- `sections/runwell-pdp-trust.liquid`
+
+## Config
+
+See `module.json` config schema. Defaults match the original Lushi defaults; override per client in `runwell.config.json`.
+
+## Lineage
+
+This module was extracted from the Lushi build (Capital V) and generalised. The original lives at `lushi-shopify/sections/lushi-pdp-trust.liquid`. The toolkit version uses `runwell-` class prefixes and pulls brand vars from the client config.

package/modules/pdp-trust-checks/module.json

@@ -0,0 +1,49 @@
+{
+  "name": "pdp-trust-checks",
+  "version": "0.1.0",
+  "category": "pdp",
+  "description": "Lushi PDP trust module migrated from Lushi.",
+  "files": {
+    "sections": [
+      "sections/runwell-pdp-trust.liquid"
+    ]
+  },
+  "config": {
+    "schema": {
+      "eyebrow": {
+        "type": "string",
+        "default": "How we picked this",
+        "label": "Eyebrow"
+      },
+      "heading": {
+        "type": "string",
+        "default": "Four checks, every product.",
+        "label": "Heading"
+      },
+      "lede": {
+        "type": "string",
+        "default": "We do not stock everything. Every product on Lushi has to clear these four checks before it gets a page.",
+        "label": "Lede"
+      },
+      "background_color": {
+        "type": "string",
+        "default": "#F5F0EE",
+        "label": "Background color"
+      },
+      "text_color": {
+        "type": "string",
+        "default": "#0B3D38",
+        "label": "Text color"
+      },
+      "link_label": {
+        "type": "string",
+        "default": "Read all our standards",
+        "label": "Link label"
+      },
+      "link_url": {
+        "type": "string",
+        "label": "Link URL"
+      }
+    }
+  }
+}

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

@@ -0,0 +1,141 @@
+{%- comment -%}
+  Lushi 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 -%}
+
+<section
+  class="runwell-pdp-trust"
+  style="background: {{ section.settings.background_color }}; color: {{ section.settings.text_color }};"
+>
+  <div class="runwell-pdp-trust__inner" 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.8rem;">
+        {{ 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 0 1rem 0; max-width: 22ch;">
+        {{ 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 0 2.5rem 0;">
+        {{ section.settings.lede }}
+      </p>
+    {%- endif -%}
+
+    <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); gap: 1.6rem; margin-top: 2rem;">
+      {%- for block in section.blocks -%}
+        <div {{ block.shopify_attributes }} style="border-top: 2px solid currentColor; padding-top: 1rem; opacity: 0.92;">
+          <div style="font-family: var(--font-body-family); font-size: 0.75rem; font-weight: 700; letter-spacing: 0.18em; text-transform: uppercase; opacity: 0.6; margin-bottom: 0.4rem;">
+            {{ block.settings.eyebrow | default: forloop.index | prepend: 'Check ' }}
+          </div>
+          <h3 style="font-family: var(--font-heading-family); font-style: italic; font-weight: 400; font-size: 1.25rem; line-height: 1.2; margin: 0 0 0.5rem 0;">
+            {{ block.settings.title }}
+          </h3>
+          <p style="font-family: var(--font-body-family); font-size: 0.92rem; line-height: 1.6; opacity: 0.85; margin: 0;">
+            {{ block.settings.body }}
+          </p>
+        </div>
+      {%- endfor -%}
+    </div>
+
+    {%- if section.settings.link_label != blank -%}
+      <div style="margin-top: 2.5rem;">
+        <a href="{{ section.settings.link_url | default: '/pages/standards' }}"
+           style="font-family: var(--font-body-family); font-weight: 700; font-size: 0.9rem; letter-spacing: 0.04em; text-transform: uppercase; text-decoration: underline; text-underline-offset: 4px; text-decoration-color: var(--runwell-blue);">
+          {{ section.settings.link_label }} &rarr;
+        </a>
+      </div>
+    {%- endif -%}
+  </div>
+</section>
+
+{% schema %}
+{
+  "name": "Lushi PDP trust",
+  "tag": "section",
+  "class": "section-runwell-pdp-trust",
+  "settings": [
+    {
+      "type": "text",
+      "id": "eyebrow",
+      "label": "Eyebrow",
+      "default": "How we picked this"
+    },
+    {
+      "type": "text",
+      "id": "heading",
+      "label": "Heading",
+      "default": "Four checks, every product."
+    },
+    {
+      "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."
+    },
+    {
+      "type": "color",
+      "id": "background_color",
+      "label": "Background color",
+      "default": "#F5F0EE"
+    },
+    {
+      "type": "color",
+      "id": "text_color",
+      "label": "Text color",
+      "default": "#0B3D38"
+    },
+    {
+      "type": "text",
+      "id": "link_label",
+      "label": "Link label",
+      "default": "Read all our standards"
+    },
+    {
+      "type": "url",
+      "id": "link_url",
+      "label": "Link URL"
+    }
+  ],
+  "blocks": [
+    {
+      "type": "check",
+      "name": "Check",
+      "settings": [
+        {
+          "type": "text",
+          "id": "eyebrow",
+          "label": "Eyebrow",
+          "default": "Check 01"
+        },
+        {
+          "type": "text",
+          "id": "title",
+          "label": "Title"
+        },
+        {
+          "type": "textarea",
+          "id": "body",
+          "label": "Body"
+        }
+      ]
+    }
+  ],
+  "presets": [
+    {
+      "name": "Lushi 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." } },
+        { "type": "check", "settings": { "eyebrow": "Check 03", "title": "Brands that show their work.", "body": "Makers who name their facility, their testing, and their batches. No black-box white-label." } },
+        { "type": "check", "settings": { "eyebrow": "Check 04", "title": "Honest claims.", "body": "If it supports a thing, we say so. If it cures a thing, we don't list it." } }
+      ]
+    }
+  ]
+}
+{% endschema %}

package/modules/post-purchase-upsell/README.md

@@ -0,0 +1,52 @@
+# post-purchase-upsell
+
+Native Shopify post-purchase upsell that renders on the order status page. Replaces the display layer of Reconvert, OneClickUpsell, and AfterSell. App-free; no monthly fees.
+
+## What it does
+
+After a customer completes checkout, the order status page surfaces a "Complete the ritual" strip with 3 complementary products. Each card deep-links to its PDP with a discount code auto-applied via URL parameter, encouraging the second order before the customer leaves the page.
+
+The complementary product picker uses a fallback chain:
+
+1. Shopify's `recommendations.json?intent=complementary` for the first ordered item
+2. Falls back to `intent=related`
+3. Falls back to a category-aware pick from `/products.json` (skincare paired with supplements, supplements paired with skincare)
+
+## What this is NOT
+
+- Not a true one-click post-purchase add (those need Shopify Plus + Checkout UI Extensions)
+- Not an app; this is a hand-written script + paste into Shopify admin
+- Not a substitute for abandoned-cart email; pair with Shopify's built-in cart recovery emails
+
+## Config
+
+| Key | Default | Notes |
+|---|---|---|
+| `discount_code` | `WELCOME15` | Must match a discount you create in Shopify admin |
+| `discount_label` | `15% off your next order` | Shown in the lede text |
+| `max_items` | `3` | Card count, capped at 6 |
+| `heading` | `Complete the ritual.` | Section heading |
+| `eyebrow` | `While you wait` | Eyebrow tag above heading |
+| `lede` | `A few of our customers tend to add these next.` | First sentence of the lede paragraph |
+| `cross_category_logic` | `true` | If true, prefer products from a different category than what was ordered |
+
+## Merchant admin steps (one-time)
+
+1. **Create the discount code.** See `admin/discount-setup.md` (rendered into `runwell-admin/post-purchase-upsell/discount-setup.md` after sync) for the exact Shopify admin clicks.
+2. **Paste the bootstrap into Order status page.** See `admin/order-status-paste.html` (rendered into `runwell-admin/post-purchase-upsell/order-status-paste.html` after sync). Settings, Checkout, Order status page, Additional scripts, paste, save.
+
+## Testing
+
+1. Place a real test order on the dev store (use a 100% off code if available)
+2. On the thank-you page, scroll past the order summary; upsell strip renders with 3 cards
+3. Click a card; confirm `?discount={code}` query param is in URL and applies at checkout
+
+## Replaces
+
+- Reconvert (Display layer; full Reconvert also includes funnels we do not replicate)
+- One Click Upsell (display layer)
+- AfterSell (display layer)
+
+## Plan requirement
+
+Works on **Shopify Basic and up**. Order status page Additional Scripts is available on every plan that has the order status page (i.e., everyone except headless-only setups).