@runwell/shopify-toolkit 0.17.4 → 0.21.0

package/modules/INDEX.md

@@ -3,46 +3,51 @@
 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: 34.
+Total modules: 39.
 
 ## By category
 
-- **catalog**: bundle-builder, quantity-breaks, subscriptions
+- **branding**: care-coaching-medvi, product-trio-medvi
+- **catalog**: bundle-builder, quantity-breaks, runwell-bundle-system, 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, scrolling-ticker, social-proof-banner, stats-bar, testimonials, trust-badges
-- **storefront**: editorial-block, editorial-hero, faq, how-it-works
+- **social-proof**: press-bar, product-badges, reviews, scrolling-ticker, social-proof-banner, stats-bar, testimonials, testimonials-medvi, trust-badges
+- **storefront**: collection-block-medvi, 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) |
+| `bundle-builder` | catalog | (native build) | 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) |
+| `care-coaching-medvi` | branding | (native build) | sections:1 snippets:1 assets:1 | section_eyebrow, headline_pre, headline_post, headline_accent_color, block_heading, circular_text, circular_text_position, footer_link_label, layout, bg_band | (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) |
+| `collection-block-medvi` | storefront | (native build) | sections:1 assets:1 | eyebrow, headline_pre, headline_post, headline_accent_color, show_product_card, product_card_bg, benefits_heading, subhead, cta_label, layout, bg_band | (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-block` | storefront | (native build) | sections:1 assets:1 | eyebrow, heading, lede, background_color, text_color | (none) | (none) |
 | `editorial-hero` | storefront | Dawn's image-banner / video-banner |  | eyebrow, heading, subheading | video-bg, hero-with-card | (none) |
-| `exit-intent` | conversion | Privy / Justuno display layer | sections:1 assets:1 | eyebrow, heading, lede | (none) | (none) |
-| `faq` | storefront | (native build) | sections:1 | eyebrow, heading, background_color, text_color | (none) | (none) |
+| `exit-intent` | conversion | Privy / Justuno display layer | sections:1 assets:2 | eyebrow, heading, lede | (none) | (none) |
+| `faq` | storefront | (native build) | sections:1 assets: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) |
+| `how-it-works` | storefront | (native build) | sections:1 assets: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 |
+| `loyalty-tiers` | customer | (native build) | sections:1 assets: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) |
+| `product-trio-medvi` | branding | (native build) | sections:1 assets:1 | panel_heading, panel_bg, layout, bg_band | (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) |
+| `recently-viewed` | pdp | (native build) | sections:1 assets:2 | eyebrow, heading, background_color | (none) | (none) |
+| `reviews` | social-proof | (native build) | sections:1 assets:1 | heading | (none) | (none) |
 | `risk-reversal` | conversion | (native build) | sections:1 | icon, heading, body, link_label, link_url, background_color, text_color | (none) | (none) |
+| `runwell-bundle-system` | catalog | the legacy bundle-builder module | sections:6 snippets:8 assets:2 | surface_1_collection_page_enabled, surface_2_pdp_pairs_with_enabled, surface_3_home_stacks_enabled, surface_4_cart_drawer_xsell_enabled, surface_5_pdp_banner_enabled, surface_6_collection_filter_enabled, surface_2_eyebrow, surface_2_heading, surface_3_eyebrow, surface_3_heading, surface_4_eyebrow, surface_4_cta, surface_5_copy_template, cross_supplier_disclosure, home_strip_position | (none) | install-shopify-bundles + define-bundle-metafields + create-bundle-index-metaobject + create-first-bundle-product + configure-quantity-tier-discount-function + configure-free-gift-discount + create-bundles-collection-page-template + add-home-stacks-section + add-pdp-pairs-with-section + add-pdp-banner-section + verify-cart-drawer-coordination + rebuild-bundle-index |
 | `scrolling-ticker` | social-proof | announcement-bar / scrolling-text apps | sections:1 assets:1 | (none) | (none) | (none) |
 | `shipping-bar` | conversion | (native build) | sections:1 | threshold_cents, message_below, message_qualified, message_default, background_color, text_color | (none) | (none) |
 | `social-proof-banner` | social-proof | fixed-text social-proof apps | sections:1 assets:1 | (none) | (none) | (none) |
@@ -50,19 +55,26 @@ Total modules: 34.
 | `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 | app-driven review widgets at the social-proof display layer |  | eyebrow, heading, background_color, text_color | grid-quotes, carousel-ugc | (none) |
+| `testimonials-medvi` | social-proof | (native build) | sections:1 assets:1 | section_eyebrow, headline_pre, headline_post, headline_accent_color, lede, card_bg, star_color, bg_band | (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 |
+| `wishlist` | customer | Wishlist Plus, Wishlist King, Globo Wishlist | sections:1 snippets:1 assets:2 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.
+- What: DEPRECATED 2026-05-10 in favor of runwell-bundle-system (Mode A).
 - 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
 
+### care-coaching-medvi
+
+- Category: branding
+- What: Brand-promise section: portrait card + circular rotating text mark + 2-color headline + body + footer CTA line.
+- Files: sections:1 snippets:1 assets:1
+- Config: section_eyebrow, headline_pre, headline_post, headline_accent_color, block_heading, circular_text, circular_text_position, footer_link_label, layout, bg_band
+
 ### cart-cross-sell
 
 - Category: conversion
@@ -86,6 +98,13 @@ Total modules: 34.
 - Files: snippets:1
 - Config: icon, usp_1, usp_2, usp_3
 
+### collection-block-medvi
+
+- Category: storefront
+- What: Duplex category section: product hero card on one side; eyebrow + split-color headline + benefits checklist + 2 lifestyle photos + CTA on the other.
+- Files: sections:1 assets:1
+- Config: eyebrow, headline_pre, headline_post, headline_accent_color, show_product_card, product_card_bg, benefits_heading, subhead, cta_label, layout, bg_band
+
 ### comparison-table
 
 - Category: pdp
@@ -104,7 +123,7 @@ Total modules: 34.
 
 - Category: storefront
 - What: Editorial introduction block: eyebrow + serif italic heading + lede + body.
-- Files: sections:1
+- Files: sections:1 assets:1
 - Config: eyebrow, heading, lede, background_color, text_color
 
 ### editorial-hero
@@ -120,14 +139,14 @@ Total modules: 34.
 - Category: conversion
 - Replaces: Privy / Justuno display layer
 - What: Exit-intent popup with email capture.
-- Files: sections:1 assets:1
+- Files: sections:1 assets:2
 - Config: eyebrow, heading, lede
 
 ### faq
 
 - Category: storefront
 - What: FAQ accordion.
-- Files: sections:1
+- Files: sections:1 assets:1
 - Config: eyebrow, heading, background_color, text_color
 
 ### gift-with-purchase
@@ -142,7 +161,7 @@ Total modules: 34.
 
 - Category: storefront
 - What: How-it-works section: side-image + multi-step explainer.
-- Files: sections:1
+- Files: sections:1 assets:1
 - Config: eyebrow, heading, lede, image, asset_filename, background_color, text_color, cta_label, cta_link
 
 ### inventory-urgency
@@ -155,7 +174,7 @@ Total modules: 34.
 
 - Category: customer
 - What: Lifetime-spend tier card on the customer account page.
-- Files: sections:1
+- Files: sections:1 assets: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
 
@@ -203,6 +222,13 @@ Total modules: 34.
 - Files: snippets:1
 - Config: label_best_seller, label_new, label_editor_pick
 
+### product-trio-medvi
+
+- Category: branding
+- What: 3-product showcase, fan layout with center product foregrounded, soft-corner copy panel beside.
+- Files: sections:1 assets:1
+- Config: panel_heading, panel_bg, layout, bg_band
+
 ### quantity-breaks
 
 - Category: catalog
@@ -221,14 +247,14 @@ Total modules: 34.
 
 - Category: pdp
 - What: recently viewed.
-- Files: sections:1 assets:1
+- Files: sections:1 assets:2
 - Config: eyebrow, heading, background_color
 
 ### reviews
 
 - Category: social-proof
 - What: PDP reviews.
-- Files: sections:1
+- Files: sections:1 assets:1
 - Config: heading
 
 ### risk-reversal
@@ -238,6 +264,15 @@ Total modules: 34.
 - Files: sections:1
 - Config: icon, heading, body, link_label, link_url, background_color, text_color
 
+### runwell-bundle-system
+
+- Category: catalog
+- Replaces: the legacy bundle-builder module
+- What: Configurable bundles engine.
+- Files: sections:6 snippets:8 assets:2
+- Config: surface_1_collection_page_enabled, surface_2_pdp_pairs_with_enabled, surface_3_home_stacks_enabled, surface_4_cart_drawer_xsell_enabled, surface_5_pdp_banner_enabled, surface_6_collection_filter_enabled, surface_2_eyebrow, surface_2_heading, surface_3_eyebrow, surface_3_heading, surface_4_eyebrow, surface_4_cta, surface_5_copy_template, cross_supplier_disclosure, home_strip_position
+- Admin steps: install-shopify-bundles + define-bundle-metafields + create-bundle-index-metaobject + create-first-bundle-product + configure-quantity-tier-discount-function + configure-free-gift-discount + create-bundles-collection-page-template + add-home-stacks-section + add-pdp-pairs-with-section + add-pdp-banner-section + verify-cart-drawer-coordination + rebuild-bundle-index
+
 ### scrolling-ticker
 
 - Category: social-proof
@@ -290,6 +325,13 @@ Total modules: 34.
 - Config: eyebrow, heading, background_color, text_color
 - Variants: grid-quotes, carousel-ugc
 
+### testimonials-medvi
+
+- Category: social-proof
+- What: Two horizontal marquee rows of testimonial cards.
+- Files: sections:1 assets:1
+- Config: section_eyebrow, headline_pre, headline_post, headline_accent_color, lede, card_bg, star_color, bg_band
+
 ### trust-badges
 
 - Category: social-proof
@@ -302,7 +344,7 @@ Total modules: 34.
 - Category: customer
 - Replaces: Wishlist Plus, Wishlist King, Globo Wishlist
 - What: Native wishlist using localStorage.
-- Files: sections:1 snippets:1 assets:1 templates:1
+- Files: sections:1 snippets:1 assets:2 templates:1
 - Config: max_items
 - Admin steps: create-wishlist-page
 

package/modules/_shared/css-tokens/assets/runwell-tokens.css

@@ -1,7 +1,10 @@
-/* Runwell Shopify Toolkit: brand tokens.
-   Generated from runwell.config.json brand vars. Every other module
-   references these via var(--runwell-X). Do not hand-edit in client
-   themes; re-run runwell-shopify sync to update.
+/* Runwell Shopify Toolkit: brand and design tokens.
+
+   Section 1 (brand): generated from runwell.config.json brand vars.
+   Re-run runwell-shopify sync to update.
+
+   Section 2 (design system): toolkit-wide constants. Tenants override
+   in their own tenant-brand.css if they need a different scale.
 
    --runwell-tertiary is the canonical brand-tertiary token; the
    --runwell-rain-forrest alias is preserved for one minor cycle of
@@ -10,6 +13,7 @@
    brand.tertiary in runwell.config.json.
 */
 :root {
+  /* Brand colors (interpolated from runwell.config.json) */
   --runwell-primary: {{brand.primary}};
   --runwell-accent: {{brand.accent}};
   --runwell-cream: {{brand.cream}};
@@ -18,4 +22,20 @@
   --runwell-blue: {{brand.blue}};
   --runwell-tertiary: {{brand.tertiary}};
   --runwell-rain-forrest: {{brand.tertiary}};
+
+  /* Design system: semantic surfaces.
+     Components reference these so the theme controls the default look.
+     Tenants override in tenant-brand.css to retarget any brand color. */
+  --runwell-surface-card: var(--runwell-oat);
+  --runwell-surface-card-alt: color-mix(in srgb, var(--runwell-celadon) 18%, white);
+
+  /* Design system: corner radii */
+  --runwell-radius-sm: 4px;
+  --runwell-radius-md: 12px;
+  --runwell-radius-lg: 20px;
+  --runwell-radius-xl: 32px;
+
+  /* Design system: elevation */
+  --runwell-shadow-card: 0 2px 8px rgba(0, 0, 0, 0.04);
+  --runwell-shadow-elevated: 0 8px 24px rgba(0, 0, 0, 0.06);
 }

package/modules/_shared/css-tokens/module.json

@@ -1,8 +1,8 @@
 {
   "name": "_shared/css-tokens",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "category": "foundation",
-  "description": "CSS custom properties published as :root vars so every Runwell module pulls brand colors from one source. Always synced.",
+  "description": "CSS custom properties published as :root vars. Brand colors interpolated from runwell.config.json. Design system tokens (radii, shadows) hardcoded as toolkit-wide constants. Always synced.",
   "always_enabled": true,
   "files": {
     "assets": ["assets/runwell-tokens.css"]

package/modules/_shared/css-typography/assets/runwell-typography.css

@@ -4,6 +4,11 @@
    sliders in layout/theme.liquid) so every toolkit module renders type
    that scales uniformly when a merchant adjusts the sliders.
 
+   Sizes are Dawn-aligned. Dawn sets html font-size to
+   calc(var(--font-body-scale) * 62.5%), so 1rem equals 10px when body
+   scale is 1.0. Our tokens land in the readability range Dawn uses for
+   its own headings and captions (1.2rem to 1.8rem).
+
    Modules reference these via var(--runwell-X-size). Tenant CSS may also
    reference them directly OR compose its own scale-aware sizes using
    calc(var(--font-body-scale) * Xrem) and calc(var(--font-heading-scale) * Xrem).
@@ -11,13 +16,16 @@
    Do not hand-edit in client themes; re-run runwell-shopify sync to update.
 */
 :root {
-  /* Body-scale derived. Eyebrows, captions, ledes, body, CTAs. */
-  --runwell-eyebrow-size:  calc(var(--font-body-scale) * 0.78rem);
-  --runwell-caption-size:  calc(var(--font-body-scale) * 0.85rem);
-  --runwell-meta-size:     calc(var(--font-body-scale) * 0.92rem);
-  --runwell-cta-size:      calc(var(--font-body-scale) * 1.15rem);
+  /* Body-scale derived. Eyebrows, captions, meta, body, ledes, CTAs.
+     Dawn-aligned: smallest readable text at 1.2rem (12px), Dawn body at
+     1.5rem (15px), our body slightly larger at 1.6rem (16px) for
+     component readability inside cards and sections. */
+  --runwell-eyebrow-size:  calc(var(--font-body-scale) * 1.2rem);
+  --runwell-caption-size:  calc(var(--font-body-scale) * 1.3rem);
+  --runwell-meta-size:     calc(var(--font-body-scale) * 1.4rem);
+  --runwell-cta-size:      calc(var(--font-body-scale) * 1.5rem);
   --runwell-body-size:     calc(var(--font-body-scale) * 1.6rem);
-  --runwell-lede-size:     calc(var(--font-body-scale) * 1.7rem);
+  --runwell-lede-size:     calc(var(--font-body-scale) * 1.8rem);
 
   /* Heading-scale derived. Section titles, big numbers, hero/aura titles. */
   --runwell-h4-size: calc(var(--font-heading-scale) * 1.7rem);

package/modules/_shared/css-typography/module.json

@@ -1,8 +1,8 @@
 {
   "name": "_shared/css-typography",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "category": "foundation",
-  "description": "Typography tokens published as :root vars. Every Runwell module references these instead of hardcoding rem values, so type scale responds to Dawn's body_scale and heading_scale Theme Editor sliders. Always synced.",
+  "description": "Typography tokens published as :root vars. Every Runwell module references these instead of hardcoding rem values, so type scale responds to Dawn's body_scale and heading_scale Theme Editor sliders. Sizes are Dawn-aligned (eyebrow 1.2rem, body 1.6rem, etc.). Always synced.",
   "always_enabled": true,
   "files": {
     "assets": ["assets/runwell-typography.css"]

package/modules/bundle-builder/README.md

@@ -1,4 +1,9 @@
-# bundle-builder
+# bundle-builder (deprecated)
+
+> **Deprecated since toolkit 0.21.0.** Use `runwell-bundle-system` (Mode A: quantity tiers) instead.
+> This module continues to function for tenants pinned to it; removal target version is 0.22.0.
+>
+> **Migration path:** set `modules.bundle-builder.enabled` to false in `runwell.config.json`, enable `runwell-bundle-system`, and set `bundle_mode: "quantity_tiers"` on the bundle product via the `runwell.bundle_mode` metafield. See `_clients/capital-v/lushi/specs/bundle-system/phase-plan.md` v1.1 for the full Lusha cutover plan.
 
 PDP section for build-your-own-bundle merchandising. Slideshow gallery + thumbnail nav + radio bundle picker (1x / 2x / 3x with savings, free-ship and free-gift badges) + sticky ATC + FOMO countdown + scarcity. Migrated from Lusha's bundle-selector.
 

package/modules/bundle-builder/module.json

@@ -2,7 +2,11 @@
   "name": "bundle-builder",
   "version": "0.1.0",
   "category": "catalog",
-  "description": "Build-your-own-bundle PDP section. Slideshow gallery + thumbnail nav + radio bundle picker (1x / 2x / 3x with savings, free-ship and free-gift badges) + sticky ATC + FOMO countdown + scarcity. Migrated from Lusha (guabrasha-store/sections/bundle-selector.liquid). Replaces BYOB-style bundle apps.",
+  "deprecated": true,
+  "deprecated_in_favor_of": "runwell-bundle-system",
+  "deprecated_since": "0.21.0",
+  "removal_target_version": "0.22.0",
+  "description": "DEPRECATED 2026-05-10 in favor of runwell-bundle-system (Mode A). Build-your-own-bundle PDP section. Slideshow gallery + thumbnail nav + radio bundle picker (1x / 2x / 3x with savings, free-ship and free-gift badges) + sticky ATC + FOMO countdown + scarcity. Lusha migration to runwell-bundle-system Mode A happens in v1.1; module removed at toolkit 0.22.0.",
   "files": {
     "sections": ["sections/runwell-bundle-builder.liquid"],
     "assets": ["assets/runwell-bundle-builder.css"]

package/modules/care-coaching-medvi/README.md

@@ -0,0 +1,46 @@
+# care-coaching-medvi
+
+Brand-promise section. Centered eyebrow + 2-color headline at top; large portrait card on one side; block (heading + body) on the other; circular rotating text mark anchored to a corner of the section; footer eyebrow + link below.
+
+Category: `branding`
+
+The distinguishing visual is the **circular rotating text mark** ("WITH YOU FROM START TO SUCCESS" in medvi's reference), rendered as inline SVG `textPath` along a closed circle, slowly rotating via CSS animation. Respects `prefers-reduced-motion`.
+
+## Files
+
+- `sections/runwell-care-coaching-medvi.liquid`
+- `snippets/runwell-care-coaching-medvi-circular-text.liquid` (SVG textPath generator, isolated for reuse)
+- `assets/runwell-care-coaching-medvi.css`
+
+## Layout
+
+- Section eyebrow (centered, tracked uppercase) + 2-color split headline span across the top, full width.
+- Inner grid: portrait card on one side (4:5), block (eyebrow + heading + body) on the other.
+- Circular text mark anchored to a corner of the section (`top-right` default, `top-left` / `bottom-right` / `bottom-left` available).
+- Footer line: small eyebrow plus link, centered below the inner.
+
+## Tokens consumed
+
+Brand: `--runwell-primary`, `--runwell-tertiary`, `--runwell-oat`, `--runwell-blue`. Design system: `--runwell-radius-xl`. Typography: `--runwell-eyebrow-size`, `--runwell-h2-size`, `--runwell-h3-size`, `--runwell-body-size`, `--runwell-meta-size`.
+
+## Lineage
+
+Extracted from `https://home.medvi.org/` on 2026-05-06. Framer label: `Care Coaching`. Scrape path: `_clients/capital-v/lushi/research/medvi-reference/site-scrape/`.
+
+The medvi reference shot:
+- Eyebrow: `BETTER IS POSSIBLE, AND WE BUILT FOR IT.`
+- Headline: `Modern healthcare,` (black) `built around you` (green accent), centered.
+- Portrait: woman in beige sweater on warm-grey background.
+- Circular mark: `WITH YOU FROM START TO SUCCESS` in soft tan, top-right of inner card.
+
+## Tenant overrides
+
+- `runwell.config.json` brand block: rewires the global tokens.
+- Per-instance Theme Editor: section eyebrow, headline split, accent color, portrait + card tint, block heading/eyebrow/body, circular text content + color + corner position, footer eyebrow + link, layout (portrait-left vs portrait-right), bg band.
+
+## Notes
+
+- Circular mark animation: 30s per full turn, linear, infinite. Stops on `prefers-reduced-motion: reduce`.
+- The SVG `textPath` snippet uses `id_suffix: section.id` to avoid id collisions when the section is dropped multiple times on the same page.
+- Mobile: stacks portrait above block. Circular mark scales smaller and pulls in to corners.
+- Block has its own oat-tinted background by default to lift it visually from the white section bg, mirroring medvi's reference. Override via `portrait_card_bg`-style additions if a different background is needed.

package/modules/care-coaching-medvi/assets/runwell-care-coaching-medvi.css

@@ -0,0 +1,241 @@
+/* Runwell care-coaching-medvi.
+
+   Brand-promise section. Centered eyebrow + 2-color headline at top;
+   large portrait card on one side; block (heading + body) on the
+   other; circular rotating text mark in a corner; footer line below.
+
+   Tokens: --runwell-tertiary, --runwell-oat, --runwell-radius-xl.
+   Typography: --runwell-eyebrow-size, --runwell-h2-size, --runwell-h3-size,
+   --runwell-body-size, --runwell-meta-size.
+*/
+
+.runwell-care-coaching-medvi {
+  padding: clamp(3rem, 8vw, 7rem) clamp(1.5rem, 4vw, 4rem);
+  font-family: var(--font-body-family, inherit);
+  color: var(--runwell-tertiary, #0B3D38);
+  position: relative;
+}
+
+.runwell-care-coaching-medvi--bg-white {
+  background: #ffffff;
+}
+
+.runwell-care-coaching-medvi--bg-oat {
+  background: var(--runwell-oat, #F5F0EE);
+}
+
+.runwell-care-coaching-medvi--bg-celadon-tint {
+  background: color-mix(in srgb, var(--runwell-celadon, #ADDDBD) 18%, white);
+}
+
+.runwell-care-coaching-medvi__section-eyebrow {
+  font-size: var(--runwell-eyebrow-size, 0.78rem);
+  letter-spacing: 0.16em;
+  text-transform: uppercase;
+  font-weight: 600;
+  margin: 0 0 1rem;
+  text-align: center;
+  opacity: 0.85;
+}
+
+.runwell-care-coaching-medvi__headline {
+  font-family: var(--font-heading-family, inherit);
+  font-size: var(--runwell-h2-size, clamp(3rem, 5vw, 4.8rem));
+  font-weight: 700;
+  line-height: 1.1;
+  margin: 0 0 clamp(2rem, 5vw, 4rem);
+  text-align: center;
+  letter-spacing: -0.01em;
+  max-width: 18ch;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+.runwell-care-coaching-medvi__headline-pre,
+.runwell-care-coaching-medvi__headline-post {
+  display: block;
+}
+
+.runwell-care-coaching-medvi__inner {
+  position: relative;
+  display: grid;
+  grid-template-columns: 1fr;
+  gap: clamp(1.5rem, 3vw, 2.5rem);
+  max-width: 1200px;
+  margin: 0 auto;
+  align-items: stretch;
+}
+
+@media (min-width: 768px) {
+  .runwell-care-coaching-medvi__inner {
+    grid-template-columns: 1fr 1fr;
+  }
+
+  .runwell-care-coaching-medvi--portrait-right .runwell-care-coaching-medvi__inner {
+    direction: rtl;
+  }
+
+  .runwell-care-coaching-medvi--portrait-right .runwell-care-coaching-medvi__inner > * {
+    direction: ltr;
+  }
+}
+
+.runwell-care-coaching-medvi__portrait-card {
+  border-radius: var(--runwell-radius-xl, 32px);
+  overflow: hidden;
+  aspect-ratio: 4 / 5;
+}
+
+.runwell-care-coaching-medvi__portrait-card img {
+  display: block;
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+.runwell-care-coaching-medvi__block {
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  gap: clamp(0.75rem, 2vw, 1.25rem);
+  padding: clamp(1.5rem, 4vw, 3rem) clamp(0.5rem, 2vw, 2rem);
+}
+
+.runwell-care-coaching-medvi__block--bg-transparent {
+  background: transparent;
+  padding-left: clamp(1rem, 2vw, 2rem);
+  padding-right: clamp(1rem, 2vw, 2rem);
+}
+
+/* Theme-driven default: tenant's design system decides the surface color
+   via --runwell-surface-card. Falls back to oat if the token is missing. */
+.runwell-care-coaching-medvi__block--bg-card {
+  background: var(--runwell-surface-card, var(--runwell-oat, #F5F0EE));
+  border-radius: var(--runwell-radius-xl, 32px);
+}
+
+/* Explicit named overrides for tenants who want a specific brand color
+   regardless of the theme's surface-card token. */
+.runwell-care-coaching-medvi__block--bg-oat-card {
+  background: var(--runwell-oat, #F5F0EE);
+  border-radius: var(--runwell-radius-xl, 32px);
+}
+
+.runwell-care-coaching-medvi__block--bg-celadon-card {
+  background: color-mix(in srgb, var(--runwell-celadon, #ADDDBD) 18%, white);
+  border-radius: var(--runwell-radius-xl, 32px);
+}
+
+.runwell-care-coaching-medvi__block-eyebrow {
+  font-size: var(--runwell-eyebrow-size, 0.78rem);
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+  font-weight: 600;
+  margin: 0;
+  opacity: 0.7;
+}
+
+.runwell-care-coaching-medvi__block-heading {
+  font-family: var(--font-heading-family, inherit);
+  font-size: var(--runwell-h3-size, clamp(2rem, 3vw, 2.8rem));
+  font-weight: 700;
+  line-height: 1.2;
+  margin: 0;
+}
+
+.runwell-care-coaching-medvi__block-body {
+  font-size: var(--runwell-body-size, 1.6rem);
+  line-height: 1.6;
+  opacity: 0.85;
+}
+
+.runwell-care-coaching-medvi__block-body p {
+  margin: 0 0 0.5em;
+}
+
+.runwell-care-coaching-medvi__block-body p:last-child {
+  margin-bottom: 0;
+}
+
+/* ----- Circular rotating text mark ----- */
+
+.runwell-care-coaching-medvi__circular {
+  position: absolute;
+  width: clamp(110px, 14vw, 200px);
+  height: clamp(110px, 14vw, 200px);
+  z-index: 3;
+  pointer-events: none;
+}
+
+.runwell-care-coaching-medvi__circular--top-right    { top: -8%; right: -4%; }
+.runwell-care-coaching-medvi__circular--top-left     { top: -8%; left: -4%; }
+.runwell-care-coaching-medvi__circular--bottom-right { bottom: -8%; right: -4%; }
+.runwell-care-coaching-medvi__circular--bottom-left  { bottom: -8%; left: -4%; }
+
+@media (max-width: 767px) {
+  .runwell-care-coaching-medvi__circular {
+    width: clamp(80px, 22vw, 130px);
+    height: clamp(80px, 22vw, 130px);
+  }
+  .runwell-care-coaching-medvi__circular--top-right,
+  .runwell-care-coaching-medvi__circular--bottom-right { right: 0; }
+  .runwell-care-coaching-medvi__circular--top-left,
+  .runwell-care-coaching-medvi__circular--bottom-left  { left: 0; }
+}
+
+.runwell-care-coaching-medvi__circular-svg {
+  width: 100%;
+  height: 100%;
+  animation: runwell-care-coaching-medvi__rotate 30s linear infinite;
+}
+
+.runwell-care-coaching-medvi__circular-text {
+  font-size: 18px;
+  font-weight: 600;
+  letter-spacing: 0.16em;
+  font-family: var(--font-body-family, inherit);
+  text-transform: uppercase;
+}
+
+@keyframes runwell-care-coaching-medvi__rotate {
+  from { transform: rotate(0deg); }
+  to   { transform: rotate(360deg); }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .runwell-care-coaching-medvi__circular-svg {
+    animation: none;
+  }
+}
+
+/* ----- Footer ----- */
+
+.runwell-care-coaching-medvi__footer {
+  margin-top: clamp(2rem, 4vw, 3rem);
+  text-align: center;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+
+.runwell-care-coaching-medvi__footer-eyebrow {
+  font-size: var(--runwell-meta-size, 0.92rem);
+  font-weight: 600;
+  margin: 0;
+}
+
+.runwell-care-coaching-medvi__footer-link {
+  display: inline-block;
+  font-size: var(--runwell-meta-size, 0.92rem);
+  font-weight: 600;
+  color: var(--runwell-primary, #0B3D38);
+  text-decoration: underline;
+  text-underline-offset: 4px;
+  text-decoration-color: var(--runwell-blue, #8AD3CC);
+  text-decoration-thickness: 2px;
+}
+
+.runwell-care-coaching-medvi__footer-link:hover,
+.runwell-care-coaching-medvi__footer-link:focus {
+  text-decoration-color: var(--runwell-primary, #0B3D38);
+}