Merge branch 'pattern-main' into kj/e-commerce-patterns

:

docs/_includes/svgs/preview.njk

@@ -0,0 +1,10 @@
+<svg width="120" height="87" viewBox="0 0 240 178" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect y="39" width="67" height="63" rx="12" fill="#D9D9D9"/>
+<rect y="115" width="67" height="63" rx="12" fill="#D9D9D9"/>
+<rect width="67" height="19" rx="6" fill="#D9D9D9"/>
+<rect x="87" y="39" width="67" height="63" rx="12" fill="#D9D9D9"/>
+<rect x="174" y="39" width="67" height="63" rx="12" fill="#D9D9D9"/>
+<rect x="174" y="7" width="67" height="4.75" rx="2.375" fill="#D9D9D9"/>
+<rect x="87" y="115" width="67" height="63" rx="12" fill="#D9D9D9"/>
+<rect x="174" y="115" width="67" height="63" rx="12" fill="#D9D9D9"/>
+</svg>

docs/_layouts/patterns.njk

@@ -0,0 +1,5 @@
+{% extends '../_layouts/block.njk' %}
+
+{% block head %}
+<link href="{{ page.url }}../patterns.css" rel="stylesheet">
+{% endblock %}

docs/docs/patterns/app.md

@@ -1,6 +1,7 @@
 ---
 title: App
 description: TODO
+unlisted: true
 ---
 
 TODO Page Description

docs/docs/patterns/blog.md

@@ -1,6 +1,7 @@
 ---
 title: Blog
 description: TODO
+unlisted: true
 ---
 
 TODO Page Description

docs/docs/patterns/business.md

@@ -1,6 +1,7 @@
 ---
 title: Business
 description: TODO
+unlisted: true
 ---
 
 TODO Page Description

docs/docs/patterns/ecommerce-category-filter.md

@@ -1,13 +1,85 @@
 ---
 title: Category Filter
-description: TODO
+description: 'Helps the user find the right products with filters to refine search results by specific attributes.'
 parent: ecommerce
 tags: e-commerce
+icon: checkbox
 ---
 
-TODO Page Description
+## Sidebar with Checkboxes & Expandable Filters
 
-## With inline actions and expandable sidebar filters
 ```html{.example}
-
+  <h1>New Arrivals</h1>
+  <div class="wa-flank wa-align-items-start" style="--flank-size: 200px;">
+    <form class="wa-stack">
+      <wa-checkbox checked>All Products</wa-checkbox>
+      <wa-checkbox>Sale</wa-checkbox>
+      <wa-checkbox>Travel</wa-checkbox>
+      <wa-checkbox>Organization</wa-checkbox>
+      <wa-checkbox>Accessories</wa-checkbox>
+      <wa-details summary="Color" open>
+        <div class="wa-stack">
+          <wa-checkbox>White</wa-checkbox>
+          <wa-checkbox>Beige</wa-checkbox>
+          <wa-checkbox>Blue</wa-checkbox>
+          <wa-checkbox>Brown</wa-checkbox>
+          <wa-checkbox>Green</wa-checkbox>
+        </div>
+      </wa-details>
+      <wa-details summary="Category">
+        <div class="wa-stack">
+          <wa-checkbox>Outdoor</wa-checkbox>
+          <wa-checkbox>Indoor</wa-checkbox>
+          <wa-checkbox>All Weather</wa-checkbox>
+        </div>
+      </wa-details>
+      <wa-details summary="Size">
+        <div class="wa-stack">
+          <wa-checkbox>Small</wa-checkbox>
+          <wa-checkbox>Medium</wa-checkbox>
+          <wa-checkbox>Large</wa-checkbox>
+          <wa-checkbox>XL</wa-checkbox>
+          <wa-checkbox>XXL</wa-checkbox>
+        </div>
+      </wa-details>
+    </form> 
+    <div class="wa-placeholder"></div>
+  </div>
+</div>
 ```
+
+## Sidebar with Dropdowns
+
+```html{.example}
+  <h1>New Arrivals</h1>
+ <div class="wa-flank wa-align-items-start">
+  <div class="wa-stack">
+    <wa-select label="Product Type" placeholder="Products" value="all-products">
+      <wa-option value="all-products">All Products</wa-option>
+      <wa-option value="sale">Sale</wa-option>
+      <wa-option value="travel">Travel</wa-option>
+      <wa-option value="organization">Organization</wa-option>
+      <wa-option value="accessories">Accessories</wa-option>
+    </wa-select>
+    <wa-divider></wa-divider>
+    <wa-select label="Color" placeholder="Color" value="black" multiple>
+      <wa-option value="black">Black</wa-option>
+      <wa-option value="white">White</wa-option>
+      <wa-option value="gray">Gray</wa-option>
+    </wa-select>
+    <wa-select label="Category" placeholder="Category" value="outdoor" multiple>
+      <wa-option value="outdoor">Outdoor</wa-option>
+      <wa-option value="indoor">Indoor</wa-option>
+      <wa-option value="all-weather">All Weather</wa-option>
+    </wa-select>
+    <wa-select label="Size" placeholder="Size" value="xl xxl" multiple>
+      <wa-option value="s">Small</wa-option>
+      <wa-option value="m">Medium</wa-option>
+      <wa-option value="l">Large</wa-option>
+      <wa-option value="xl">XL</wa-option>
+      <wa-option value="xxl">XXL</wa-option>
+    </wa-select>
+  </div>
+  <div class="wa-placeholder"></div>
+</div>
+```

docs/docs/patterns/ecommerce-category-preview.md

@@ -1,12 +1,164 @@
 ---
 title: Category Preview
-description: TODO
+description: 'Help shoppers discover your product offerings with showcases of product categories.'
 parent: ecommerce
 tags: e-commerce
+icon: preview
 ---
 
-TODO Page Description
-
-## Three Column (WIP)
+## Split with Image Grid
 
+```html {.example}
+<div class="wa-flank wa-align-items-start" style="--flank-size: 20rem;">
+  <div class="wa-stack wa-gap-2xl">
+    <h2 class="wa-heading-xl">Casual Collection</h2>
+    <p class="wa-body-s">Look good &mdash; without looking like you're trying too hard. Our casual collection includes laid back styles that work in <em>almost</em> any situation.</p>
+    <wa-button>View the Collection</wa-button>
+  </div>
+  <div class="wa-stack">
+    <div class="wa-frame:landscape wa-border-radius-s">
+      <img 
+        src="https://images.unsplash.com/photo-1544441893-675973e31985?q=80&w=2340&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="An analog watch, cotton pants, crew neck tee, and pair of tennis shoes (Photograph by Mnz)"
+      />
+    </div>
+    <div class="wa-grid">
+      <div class="wa-frame:landscape wa-border-radius-s">
+        <img 
+          src="https://images.unsplash.com/photo-1548768041-2fceab4c0b85?q=80&w=3540&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+          alt="Stack of three folded solid color tees (Photograph by Mnz)"
+        />
+      </div>
+      <div class="wa-frame:landscape wa-border-radius-s">
+        <img 
+          src="https://images.unsplash.com/photo-1544441892-794166f1e3be?q=80&w=3540&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+          alt="Pair of bright white tennis shoes(Photograph by Mnz)"
+        />
+      </div>
+    </div>
+  </div>
+</div>
 ```
+
+## Columns with Tall Images
+
+```html {.example}
+<div class="wa-stack">
+  <h2 class="wa-heading-xl">Shop by Category</h2>
+  <div class="wa-grid">
+    <a href="" class="wa-stack wa-link-plain">
+      <div class="wa-frame:portrait wa-border-radius-s">
+        <img 
+          src="https://uploads.webawesome.com/organization.jpg"
+          alt="Inside of a closet filled with clothes on wooden hangers and integrated shelving with shoes"
+        />
+      </div>
+      <span class="wa-caption-xl">Organization</span>
+    </a>
+    <a href="" class="wa-stack wa-link-plain">
+      <div class="wa-frame:portrait wa-border-radius-s">
+        <img 
+          src="https://uploads.webawesome.com/bags.jpg"
+          alt="Young person hugging a small floral patterned book bag between their arms"
+        />
+      </div>
+      <span class="wa-caption-xl">Bags</span>
+    </a>
+    <a href="" class="wa-stack wa-link-plain">
+      <div class="wa-frame:portrait wa-border-radius-s">
+        <img 
+          src="https://uploads.webawesome.com/outdoor-2.jpg"
+          alt="Person in a mountain clearing wearing a waterproof hooded windbreaker in black and orange"
+        />
+      </div>
+      <span class="wa-caption-xl">Outdoor</span>
+    </a>
+  </div>
+</div>
+```
+
+## Columns with Cards
+
+```html {.example}
+<div class="wa-stack">
+  <div class="wa-split">
+    <h2 class="wa-heading-xl">Shop by Category</h2>
+    <a href="" class="wa-cluster">
+      <span>Browse All Categories</span>
+      <wa-icon name="arrow-right"></wa-icon>
+    </a>
+  </div>
+  <div class="wa-grid">
+    <a href="" class="wa-link-plain">
+      <wa-card style="height: 100%">
+        <img
+          slot="image"
+          src="https://img.fortawesome.com/cfa83f3c/outdoor-3x.jpg"
+          alt="Two hikers wearing long canvas pants, weatherproof jackets, and backpacks"
+        />
+        <div class="wa-stack wa-gap-xs">
+          <span class="wa-heading-m">Outdoor</span>
+          <p class="wa-caption-m">Durable canvas gear for all conditions.</p>
+        </div>
+      </wa-card>
+    </a>
+    <a href="" class="wa-link-plain">
+      <wa-card style="height: 100%">
+        <img
+          slot="image"
+          src="https://img.fortawesome.com/cfa83f3c/home.jpg"
+          alt="Woman sitting on a couch in a bright home, wearing a thick knit sweater"
+        />
+        <div class="wa-stack wa-gap-xs">
+          <span class="wa-heading-m">Home</span>
+          <p class="wa-caption-m">Cozy up on the couch and relax in soft cotton.</p>
+        </div>
+      </wa-card>
+    </a>
+    <a href="" class="wa-link-plain">
+      <wa-card style="height: 100%">
+        <img
+          slot="image"
+          src="https://img.fortawesome.com/cfa83f3c/fitness.jpg"
+          alt="Athlete training in fitted active wear tee and shorts"
+        />
+        <div class="wa-stack wa-gap-xs">
+          <span class="wa-heading-m">Active</span>
+          <p class="wa-caption-m">Get fit in style with breathable poly blends.</p>
+        </div>
+      </wa-card>
+    </a>
+  </div>
+</div>
+```
+
+## Square Image Grid
+
+```html {.example}
+<div class="wa-stack wa-gap-2xl">
+  <div class="wa-stack wa-gap-xs wa-align-items-center">
+    <h2 class="wa-heading-xl">New Arrivals</h2>
+    <p class="wa-caption-l">Explore brand new furniture to accentuate your home aesthetic &mdash; just for you.</p>
+  </div>
+<div class="wa-grid">
+  <div class="wa-stack">
+    <div class="wa-frame wa-border-radius-m">
+      <img
+        src="https://uploads.webawesome.com/indoor-furniture.jpg"
+        alt="Sunny room with a mid-century modern couch, accent chair, and elegant lamp"
+      />
+    </div>
+    <wa-button appearance="outlined">View Indoor Furniture</wa-button>
+  </div>
+  <div class="wa-stack">
+    <div class="wa-frame wa-border-radius-m">
+      <img
+        src="https://uploads.webawesome.com/outdoor-furniture.jpg"
+        alt="Covered patio with rustic wooden cabinets, writing desk, and stool"
+      />
+    </div>
+    <wa-button appearance="outlined">View Outdoor Furniture</wa-button>
+  </div>
+</div>
+</div>
+```

docs/docs/patterns/ecommerce-checkout-form.md

@@ -0,0 +1,246 @@
+---
+title: Checkout Form
+description: 'Let shoppers checkout with ease with streamlined forms to capture shipping and payment info.'
+parent: ecommerce
+tags: e-commerce
+---
+
+
+## Full Form with Order Summary Card
+
+```html {.example}
+<div class="wa-grid wa-gap-3xl">
+  <div class="wa-stack">
+    <h4>Contact</h4>
+    <wa-input type="email" label="Email Address"></wa-input>
+    <wa-divider></wa-divider>
+    <h4>Shipping</h4>
+    <wa-select label="Country" value="us">
+      <wa-option value="ca">Canada</wa-option>
+      <wa-option value="mx">Mexico</wa-option>
+      <wa-option value="us">United States</wa-option>
+    </wa-select>
+    <div class="wa-grid">
+      <wa-input label="First Name"></wa-input>
+      <wa-input label="Last Name"></wa-input>
+    </div>
+    <wa-input label="Company"></wa-input>
+    <wa-input label="Address"></wa-input>
+    <div class="wa-grid" style="--min-column-size: 10ch;">
+      <wa-input label="City"></wa-input>
+      <wa-input label="State"></wa-input>
+      <wa-input label="Postal Code"></wa-input>
+    </div>
+    <wa-input label="Phone"></wa-input>
+    <wa-divider></wa-divider>
+      <wa-radio-group label="Shipping Method" name="shipping-method" value="standard" orientation="horizontal">
+      <wa-radio value="standard" hint="7-10  business days">Standard</wa-radio>
+      <wa-radio value="express" hint="2-5 business days">Express</wa-radio>
+    </wa-radio-group>
+    <wa-divider></wa-divider>
+    <h4>Payment</h4>
+    <wa-radio-group label="Payment Method" name="payment-method" value="credit" orientation="horizontal">
+      <wa-radio value="credit">Credit Card</wa-radio>
+      <wa-radio value="paypal">Paypal</wa-radio>
+    </wa-radio-group>
+    <wa-input label="Card Number"></wa-input>
+    <wa-input label="Name on Card"></wa-input>
+    <div class="wa-grid">
+      <wa-input label="Expiration Date" placeholder="MM/YY"></wa-input>
+      <wa-input label="CVC"></wa-input>
+    </div>
+  </div>
+  <div class="wa-stack">
+    <h4>Order Summary</h4>
+    <wa-card>
+      <div class="wa-stack">
+        <div class="wa-flank wa-align-items-start" style="--flank-size: 7rem">
+          <div class="wa-frame wa-border-radius-s">
+            <img src="https://images.unsplash.com/photo-1595950653106-6c9ebd614d3a?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w1OTAyOTl8MHwxfGFsbHx8fHx8fHx8fDE3MTg2NDM1MzB8&ixlib=rb-4.0.3&q=80&w=1080" alt="">
+          </div>
+          <div class="wa-stack wa-gap-xs">
+            <div class="wa-split">
+              <span class="wa-heading-s">Dolce Runners</span>
+              <wa-icon-button name="trash" label="Remove from cart"></wa-icon-button>
+            </div>
+            <span class="wa-caption-m">Cream/Seafoam</span>
+            <span class="wa-caption-m">12.5</span>
+            <div class="wa-split">
+              <span>$135.00</span>
+              <wa-select value="1" size="small" style="max-width: 8ch">
+                <wa-option value="1">1</wa-option>
+                <wa-option value="2">2</wa-option>
+                <wa-option value="3">3</wa-option>
+              </wa-select>
+            </div>
+          </div>
+        </div>
+        <wa-divider></wa-divider>
+        <div class="wa-flank wa-align-items-start" style="--flank-size: 7rem">
+          <div class="wa-frame wa-border-radius-s">
+            <img src="https://images.unsplash.com/photo-1514989940723-e8e51635b782?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w1OTAyOTl8MHwxfGFsbHx8fHx8fHx8fDE3MTg2NDM1Njh8&ixlib=rb-4.0.3&q=80&w=1080" alt="">
+          </div>
+          <div class="wa-stack wa-gap-xs">
+            <div class="wa-split">
+              <span class="wa-heading-s">Dunk High</span>
+              <wa-icon-button name="trash" label="Remove from cart"></wa-icon-button>
+            </div>
+            <span class="wa-caption-m">Sand/Amber/Black</span>
+            <span class="wa-caption-m">12.5</span>
+            <div class="wa-split">
+              <span>$180.00</span>
+              <wa-select value="1" size="small" style="max-width: 8ch">
+                <wa-option value="1">1</wa-option>
+                <wa-option value="2">2</wa-option>
+                <wa-option value="3">3</wa-option>
+              </wa-select>
+            </div>
+          </div>
+        </div>
+        <wa-divider></wa-divider>
+        <div class="wa-flank wa-align-items-start" style="--flank-size: 7rem">
+          <div class="wa-frame wa-border-radius-s">
+            <img src="https://images.unsplash.com/photo-1606107557195-0e29a4b5b4aa?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w1OTAyOTl8MHwxfGFsbHx8fHx8fHx8fDE3MTg2NDM2MTF8&ixlib=rb-4.0.3&q=80&w=1080" alt="">
+          </div>
+          <div class="wa-stack wa-gap-xs">
+            <div class="wa-split">
+              <span class="wa-heading-s">NB Runner</span>
+              <wa-icon-button name="trash" label="Remove from cart"></wa-icon-button>
+            </div>
+            <span class="wa-caption-m">Forrest Green</span>
+            <span class="wa-caption-m">12.5</span>
+            <div class="wa-split">
+              <span>$48.99</span>
+              <wa-select value="1" size="small" style="max-width: 8ch">
+                <wa-option value="1">1</wa-option>
+                <wa-option value="2">2</wa-option>
+                <wa-option value="3">3</wa-option>
+              </wa-select>
+            </div>
+          </div>
+        </div>
+        <wa-divider></wa-divider>
+        <div class="wa-stack">
+          <div class="wa-split wa-caption-m">
+            <span>Subtotal</span>
+            <span>$363.99</span>
+          </div>
+          <div class="wa-split wa-caption-m">
+            <span>Shipping</span>
+            <span>FREE</span>
+          </div>
+          <div class="wa-split wa-heading-m">
+            <span>Total</span>
+            <span>$363.99</span>
+          </div>
+        </div>
+        <wa-divider></wa-divider>
+        <wa-button variant="brand">Confirm Order</wa-button>
+      </div>
+    </wa-card>
+  </div>
+</div>
+```
+
+## Short Form with Order Summary
+
+```html {.example}
+<div class="wa-grid wa-gap-3xl">
+  <div class="wa-stack wa-gap-xl">
+    <h2>Payment</h2>
+    <wa-input type="email" label="Email" placeholder="ex. tanderson@metacortex.com">
+      <wa-icon slot="prefix" name="envelope"></wa-icon>
+    </wa-input>
+    <wa-input label="Card Number" placeholder="1234 1234 1234 1234">
+      <wa-icon slot="prefix" name="credit-card"></wa-icon>
+    </wa-input>
+    <div class="wa-grid" style="--min-column-size: 12ch">
+      <wa-input label="Expiration" placeholder="MM/YY">
+        <wa-icon slot="prefix" name="calendar"></wa-icon>
+      </wa-input>
+      <wa-input label="CVC" placeholder="CVC">
+        <wa-icon slot="prefix" name="lock"></wa-icon>
+      </wa-input>
+    </div>
+    <wa-input label="Cardholder Name" placeholder="Thomas Anderson">
+      <wa-icon slot="prefix" name="user"></wa-icon>
+    </wa-input>
+    <div class="wa-grid" style="--min-column-size: 12ch">
+      <wa-select label="Country" value="us">
+        <wa-icon slot="prefix" name="globe"></wa-icon>
+        <wa-option value="ca">Canada</wa-option>
+        <wa-option value="us">United States</wa-option>
+        <wa-option value="mx">Mexico</wa-option>
+      </wa-select>
+      <wa-input label="ZIP" placeholder="12345">
+        <wa-icon slot="prefix" name="location-dot"></wa-icon>
+      </wa-input>
+    </div>
+    <wa-switch checked>Sign me up for more offers from this store</wa-switch>
+    <wa-button variant="brand">Pay Now</wa-button>
+  </div>
+  <div class="wa-stack wa-gap-xl">
+    <h2>Order Summary</h2>
+    <div class="wa-split">
+      <div class="wa-cluster">
+        <div class="wa-frame wa-border-radius-m" style="max-width: 4rem">
+          <img src="https://images.unsplash.com/photo-1618677366787-9727aacca7ea?q=80&w=3255&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D" alt="Glasses with black wire frames and dark tinted, circular lenses (Photograph by Colin Lloyd)">
+        </div>
+        <strong>Morpheus</strong>
+      </div>
+      <div class="wa-cluster">
+        <wa-input type="number" value="1" style="max-width: 5rem"></wa-input>
+        <span>$120.00</span>
+      </div>
+    </div>
+    <div class="wa-split">
+      <div class="wa-cluster">
+        <div class="wa-frame wa-border-radius-m" style="max-width: 4rem">
+          <img src="https://images.unsplash.com/photo-1511499767150-a48a237f0083?q=80&w=3558&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D" alt="Glasses with rose gold wire frames and green tinted, circular lenses (Photograph by Charles Deluvio)">
+        </div>
+        <div class="wa-stack wa-gap-3xs">
+          <strong>Seraph</strong>
+          <em class="wa-caption-m">Tinted</em>
+        </div>
+      </div>
+      <div class="wa-cluster">
+        <wa-input type="number" value="1" style="max-width: 5rem"></wa-input>
+        <span>$180.00</span>
+      </div>
+    </div>
+    <div class="wa-split">
+      <div class="wa-cluster">
+        <div class="wa-frame wa-border-radius-m" style="max-width: 4rem">
+          <img src="https://images.unsplash.com/photo-1547104442-a40f335740cb?q=80&w=3348&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D" alt="Glasses with tortoise shell half frames and large, rounded lenses (Photograph by Sincerely Media)">
+        </div>
+        <div class="wa-stack wa-gap-3xs">
+          <strong>Keymaker</strong>
+          <em class="wa-caption-m">Glossy</em>
+        </div>
+      </div>
+      <div class="wa-cluster">
+        <wa-input type="number" value="1" style="max-width: 5rem"></wa-input>
+        <span>$50.00</span>
+      </div>
+    </div>
+    <div class="wa-flank:end">
+      <wa-input placeholder="Discount code or gift card"></wa-input>
+      <wa-button appearance="filled">Apply</wa-button>
+    </div>
+    <div class="wa-stack wa-gap-s">
+      <div class="wa-split">
+        <span>Subtotal</span>
+        <strong>$530.00</strong>
+      </div>
+      <div class="wa-split">
+        <span>Shipping</span>
+        <span>$8.00</span>
+      </div>
+      <div class="wa-split">
+        <strong>Total</strong>
+        <strong>$538.00</strong>
+      </div>
+    </div>
+  </div>
+</div>
+```

docs/docs/patterns/ecommerce-incentives.md

@@ -0,0 +1,125 @@
+---
+title: Incentives
+description: 'Encourage shoppers to buy your products with value propositions, discounts, and promotions.'
+parent: ecommerce
+tags: e-commerce
+---
+
+## 3 Column
+
+```html{.example}
+<div class="wa-gap-3xl wa-stack" style="max-width: 960px; margin: 0 auto;">
+  <div class="wa-align-items-center wa-grid">
+    <div>
+      <span class="wa-heading-xl">Get the Best Instruction from our Educators.</span>
+      <p class="wa-caption-l">At the beginning at least, but then we realized we could make a lot more money if we kinda stopped caring about that. Our new strategy is to write a bunch of things that look really good in the headlines, then clarify in the small print but hope people don't actually read it.</p>
+    </div>
+    <div class="wa-frame wa-border-radius-l">
+      <img src="https://uploads.webawesome.com/online-learning.jpg" />
+    </div>
+    
+  </div>
+  <div class="wa-grid">
+    <div class="wa-stack wa-gap-xs">
+      <wa-icon name="stopwatch" style="font-size: 32px;"></wa-icon>
+      <span class="wa-heading-s">Learn at your Speed</span>
+      <p class="wa-caption-m">It's not actually free we just price it into the products. Someone's paying for it, and it's not us.</p>
+    </div>
+    <div class="wa-stack wa-gap-xs">
+      <wa-icon name="chart-line" style="font-size: 32px;"></wa-icon>
+      <span class="wa-heading-s">Track Progress</span>
+      <p class="wa-caption-m">If it breaks in the first 10 years we'll replace it. After that you're on your own though.</p>
+    </div>
+    <div class="wa-stack wa-gap-xs">
+      <wa-icon name="people-group" style="font-size: 32px;"></wa-icon>
+      <span class="wa-heading-s">Active Community</span>
+      <p class="wa-caption-m">If you don't like it, trade it to one of your friends for something of theirs. Don't send it here though.</p>
+    </div>
+  </div>
+</div>
+```
+## 2 Column with Cards
+
+```html{.example}
+<div class="wa-grid" style="--min-column-size: 41ch;">
+  <wa-card>
+    <div class="wa-flank">
+    <div>
+      <wa-icon name="hands" style="font-size: 2.5rem;"></wa-icon>
+    </div>
+    <div class="wa-gap-s wa-stack">
+      <span class="wa-heading-m">Hands-on training</span>
+      <p class="wa-caption-l">Upskill effectively with AI-powered coding exercises, practice tests, and quizzes.</p>
+    </div>
+    </div>
+  </wa-card>
+  <wa-card>
+    <div class="wa-flank">
+    <div>
+      <wa-icon name="medal" style="font-size: 2.5rem;"></wa-icon>
+    </div>
+    <div class="wa-gap-s wa-stack">
+      <span class="wa-heading-m">Certification prep</span>
+      <p class="wa-caption-l">Prep for industry-recognized certifications by solving real-world challenges and earn badges along the way</p>
+    </div>
+    </div>
+  </wa-card>
+  <wa-card>
+    <div class="wa-flank">
+    <div>
+      <wa-icon name="chart-line" style="font-size: 2.5rem;"></wa-icon>
+    </div>
+    <div class="wa-gap-s wa-stack">
+      <div class="wa-split wa-gap-2xs">
+        <span class="wa-heading-m">Insights and analytics</span>
+        <wa-badge appearance="filled outlined" variant="warning">Pro Plan</wa-badge>
+      </div>
+      <p class="wa-caption-l">Fast-track goals with advanced insights plus a dedicated customer success team to help drive effective learning.</p>
+    </div>
+    </div>
+  </wa-card>
+  <wa-card>
+    <div class="wa-flank">
+      <div>
+        <wa-icon name="puzzle-piece" style="font-size: 2.5rem;"></wa-icon>
+      </div>
+      <div class="wa-gap-s wa-stack">
+        <div class="wa-split wa-gap-2xs">
+          <span class="wa-heading-m">Customizable content</span>
+          <wa-badge appearance="filled outlined" variant="warning">Pro Plan</wa-badge>
+        </div>
+        <p class="wa-caption-l">Create tailored learning paths for team and organization goals and even host your own content and resources.</p>
+      </div>
+    </div>
+  </wa-card>
+</div>
+```
+
+## 4 Column
+
+```html{.example}
+<div>
+<div class="wa-grid">
+  <div class="wa-stack wa-gap-xs">
+      <wa-icon name="magnifying-glass" style="font-size: 32px;"></wa-icon>
+      <span class="wa-heading-s">SEO Consulting</span>
+      <p class="wa-caption-m">It's not actually free we just price it into the products. Someone's paying for it, and it's not us.</p>
+    </div>
+    <div class="wa-stack wa-gap-xs">
+      <wa-icon name="chalkboard-user" style="font-size: 32px;"></wa-icon>
+      <span class="wa-heading-s">In Person Training</span>
+      <p class="wa-caption-m">If it breaks in the first 10 years we'll replace it. After that you're on your own though.</p>
+    </div>
+    <div class="wa-stack wa-gap-xs">
+      <wa-icon name="people-arrows" style="font-size: 32px;"></wa-icon>
+      <span class="wa-heading-s">1 on 1 Sessions</span>
+      <p class="wa-caption-m">If you don't like it, trade it to one of your friends for something of theirs. Don't send it here though.</p>
+    </div>
+    <div class="wa-stack wa-gap-xs">
+      <wa-icon name="code" style="font-size: 32px;"></wa-icon>
+      <span class="wa-heading-s">Web Development</span>
+      <p class="wa-caption-m">If you don't like it, trade it to one of your friends for something of theirs. Don't send it here though.</p>
+    </div>
+</div>
+</div>
+```

docs/docs/patterns/ecommerce-order-history.md

@@ -1,14 +1,190 @@
 ---
 title: Order History
-description: TODO
+description: 'Empower your customers to view past purchases and track upcoming orders with comprehensive order histories.'
 parent: ecommerce
 tags: e-commerce
 ---
 
-TODO Page Description
-
-## Invoice panels
-
-```html{.example}
+## List
 
+```html {.example}
+<div class="wa-stack wa-gap-2xl">
+  <h2>Order History</h2>
+  <p class="wa-caption-m">Check the status of recent orders, manage returns, and download invoices.</p>
+  <dl class="wa-split">
+    <span class="wa-stack wa-gap-0">
+      <dt>Order number</dt>
+      <dd>WU88191111</dd>
+    </span>
+    <span class="wa-stack wa-gap-0">
+      <dt>Date placed</dt>
+      <dd>January 22, 2021</dd>
+    </span>
+    <span class="wa-stack wa-gap-0">
+      <dt>Total amount</dt>
+      <dd>$590.00</dd>
+    </span>
+    <span class="wa-cluster">
+      <wa-button variant="neutral" appearance="outlined">View Order</wa-button>
+      <wa-button variant="neutral" appearance="outlined">View Invoice</wa-button>
+    </span>
+  </dl>
+  <wa-divider></wa-divider>
+  <div class="wa-flank" style="--flank-size: 12rem">
+    <div class="wa-frame wa-border-radius-s" style="aspect-ratio: 3 / 2">
+      <img 
+        src="https://img.fortawesome.com/cfa83f3c/light-fixtures.jpg"
+        alt=""
+      />
+    </div>
+    <div class="wa-stack">
+      <div class="wa-split">
+        <span><strong>Dome Light Fixtures</strong></span>
+        <span><strong>$215.00</strong></span>
+      </div>
+      <p class="wa-caption-m">Illuminate your space with elegance and style with stunning Dome Light Fixtures. The shape of these lights complements both modern and traditional interiors.</p>
+      <div class="wa-split">
+        <wa-badge appearance="filled" variant="success">Delivered</wa-badge>
+        <div class="wa-cluster">
+          <wa-button size="small" appearance="plain" variant="neutral">View Product</wa-button>
+          <wa-button size="small" appearance="accent" variant="brand">Buy Again</wa-button>
+        </div>
+      </div> 
+    </div>
+  </div>
+  <wa-divider></wa-divider>
+  <div class="wa-flank" style="--flank-size: 12rem">
+    <div class="wa-frame wa-border-radius-s" style="aspect-ratio: 3 / 2">
+      <img
+        src="https://img.fortawesome.com/cfa83f3c/modern-chair.jpg"
+        alt=""
+      />
+    </div>
+    <div class="wa-stack">
+      <div class="wa-split">
+        <span><strong>Reading Chair</strong></span>
+        <span><strong>$115.00</strong></span>
+      </div>
+      <p class="wa-caption-m">Add a pop of color and a touch of elegance to any room with our Reading Chair featuring vibrant yellow fabric upholstery.</p>
+      <div class="wa-split">
+        <wa-badge appearance="filled" variant="brand">Out for delivery</wa-badge>
+        <div class="wa-cluster">
+          <wa-button size="small" appearance="plain" variant="neutral">View Product</wa-button>
+          <wa-button size="small" appearance="accent" variant="brand">Buy Again</wa-button>
+        </div>
+      </div>
+    </div>
+  </div>
+  <wa-divider></wa-divider>
+  <div class="wa-flank" style="--flank-size: 12rem">
+    <div class="wa-frame wa-border-radius-s" style="aspect-ratio: 3 / 2">
+      <img
+        src="https://img.fortawesome.com/cfa83f3c/sofa.jpg"
+        alt=""
+      />
+    </div>
+    <div class="wa-stack">
+      <div class="wa-split">
+        <span><strong>Custom Sofa</strong></span>
+        <span><strong>$260.00</strong></span>
+      </div>
+      <p class="wa-caption-m">Experience luxury and comfort like never before with our Custom Sofa, designed to elevate any living space. This sofa features exquisite velvet upholstery for an air of sophistication.</p>
+      <div class="wa-split">
+        <wa-badge appearance="filled" variant="neutral">Preparing to ship</wa-badge>
+        <div class="wa-cluster">
+          <wa-button size="small" appearance="plain" variant="neutral">View Product</wa-button>
+          <wa-button size="small" appearance="accent" variant="brand">Buy Again</wa-button>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+```
+
+## Invoice Table
+
+```html {.example}
+<div class="wa-stack wa-gap-2xl">
+  <wa-callout appearance="filled" variant="neutral">
+    <div class="wa-flank:end wa-align-items-center">
+      <dl class="wa-grid">
+        <div class="wa-stack wa-gap-0">
+          <dt>Date Placed</dt>
+          <dd>
+            <wa-format-date date="2021-01-22" month="long" day="numeric" year="numeric"></wa-format-date>
+          </dd>
+        </div>
+        <div class="wa-stack wa-gap-0">
+          <dt>Order Number</dt>
+          <dd>WU88191111</dd>
+        </div>
+        <div class="wa-stack wa-gap-0">
+          <dt>Total Amount</dt>
+          <dd>$590.00</dd>
+        </div>
+      </dl>
+      <wa-button>View Invoice</wa-button>
+    </div>
+  </wa-callout>
+  <table>
+    <thead>
+      <tr>
+        <th>Product</th>
+        <th>Price</th>
+        <th>Status</th>
+        <th>Info</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr>
+        <td>
+          <div class="wa-cluster wa-align-items-start">
+            <div class="wa-frame:landscape wa-border-radius-s" style="max-width: 8rem">
+              <img
+                src="https://img.fortawesome.com/cfa83f3c/light-fixtures.jpg"
+                alt=""
+              />
+            </div>
+            <span>Dome Light Fixtures</span>
+          </div>
+        </td>
+        <td>$215.00</td>
+        <td>Delivered Jan 25, 2021</td>
+        <td><a href="">View</a></td>
+      </tr>
+      <tr>
+        <td>
+          <div class="wa-cluster wa-align-items-start">
+            <div class="wa-frame:landscape wa-border-radius-s" style="max-width: 8rem">
+              <img
+                src="https://img.fortawesome.com/cfa83f3c/modern-chair.jpg"
+                alt=""
+              />
+            </div>
+            <span>Reading Chair</span>
+          </div>
+        </td>
+        <td>$115.00</td>
+        <td>Delivered Jan 25, 2021</td>
+        <td><a href="">View</a></td>
+      </tr>
+      <tr>
+        <td>
+          <div class="wa-cluster wa-align-items-start">
+            <div class="wa-frame:landscape wa-border-radius-s" style="max-width: 8rem">
+              <img
+                src="https://img.fortawesome.com/cfa83f3c/sofa.jpg"
+                alt=""
+              />
+            </div>
+            <span>Custom Sofa</span>
+          </div>
+        </td>
+        <td>$260.00</td>
+        <td>Delivered Jan 25, 2021</td>
+        <td><a href="">View</a></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
 ```

docs/docs/patterns/ecommerce-order-summary.md

@@ -1,13 +1,296 @@
 ---
-title: Product List
-description: TODO
+title: Order Summary
+description: 'Give shoppers confidence in their purchases with summaries of everything included in their order.'
 parent: ecommerce
 tags: e-commerce
 ---
 
-TODO Page Description
-
-## With split image
-```html{.example}
-
+## Simple
+```html {.example}
+<div class="wa-stack wa-gap-xl">
+  <wa-callout variant="success">
+    <em>Payment Successful</em>
+    <wa-icon slot="icon" name="circle-check"></wa-icon>
+  </wa-callout>
+  <wa-card>
+    <div class="wa-stack wa-gap-xl">
+      <h2>Thank you for ordering from us!</h2>
+      <p class="wa-caption-l">We're processing your order now. A confirmation email will be sent to you momentarily!</p>
+      <dl class="wa-cluster">
+        <dt>Order #</dt>
+        <dd>49548790-24545</dd>
+      </dl>
+      <wa-divider></wa-divider>
+      <div class="wa-flank:end wa-align-items-start wa-gap-xl" style="--flank-size: 14em">
+        <div class="wa-stack wa-gap-xl">
+          <ul class="wa-stack wa-gap-xl">
+            <li class="wa-flank wa-align-items-start">
+              <div class="wa-frame wa-border-radius-s">
+                <img 
+                  src="https://uploads.webawesome.com/vase-1.jpg"
+                  alt=""
+                />
+              </div>
+              <div class="wa-split">
+                <span class="wa-heading-s">Spotted Flower Pot</span>
+                <span>$75.00</span>
+              </div>
+            </li>
+            <wa-divider></wa-divider>
+            <li class="wa-flank wa-align-items-start">
+              <div class="wa-frame wa-border-radius-s">
+                <img 
+                  src="https://uploads.webawesome.com/decorative-vase.jpg"
+                  alt=""
+                />
+              </div>
+              <div class="wa-split">
+                <span class="wa-heading-s">Decorative Vase</span>
+                <span>$51.00</span>
+              </div>
+            </li>
+          </ul>
+          <wa-divider></wa-divider>
+          <dl class="wa-stack wap-gap-2xs wa-caption-l">
+            <div class="wa-split">
+              <dt>Subtotal</dt>
+              <dd>$126.00</dd>
+            </div>
+            <div class="wa-split">
+              <dt>Shipping</dt>
+              <dd>$8.00</dd>
+            </div>
+            <div class="wa-split">
+              <dt>Taxes</dt>
+              <dd>$6.40</dd>
+            </div>
+            <div class="wa-split">
+              <dt>Total</dt>
+              <dd>$140.40</dd>
+            </div>
+          </dl>
+        </div>
+        <wa-callout variant="neutral" appearance="filled">
+          <dl class="wa-stack" style="margin: 0">
+            <dt>Shipping Address</dt>
+            <dd>
+              <address class="wa-stack wa-gap-2xs">
+                <span>Donna Noble</span>
+                <span>56 Front Street</span>
+                <span>Las Cruces, NM 56929</span>
+              </address>
+            </dd>
+            <dt>Payment Information</dt>
+            <dd class="wa-flank wa-gap-s">
+                <wa-icon label="Visa" class="wa-body-xl" family="brands" name="cc-visa" style="color: #224DBA;"></wa-icon>
+                <span>Ending with 9065</span>
+            </dd>
+          </dl>
+        </wa-callout>
+      </div>
+    </div>
+  </wa-card>
+  <wa-button size="large" variant="brand" appearance="plain">
+    <wa-icon slot="suffix" name="arrow-right" variant="solid"></wa-icon>
+    Continue Shopping
+  </wa-button>
+</div>
+```
+
+## With Details
+
+```html {.example}
+<div class="wa-stack">
+  <h2>Order Details</h2>
+  <div class="wa-split">
+    <div class="wa-cluster">
+      <span>Order placed <wa-format-date date="2025-02-26T09:00:00-04:00" month="long" day="numeric" year="numeric"></wa-format-date></span>
+      <wa-divider vertical style="height: 2em"></wa-divider>
+      <span>Order # 45646456-4656-4542</span>
+    </div>
+    <wa-button size="small" appearance="outlined" pill>View Invoice</wa-button>
+  </div>
+  <wa-card>
+    <div class="wa-split wa-align-items-start">
+      <div class="wa-stack">
+        <h3 class="wa-heading-s">Shipping Address</h3>
+        <address class="wa-stack wa-gap-xs wa-caption-m">
+          <span>Johnny Blaze</span>
+          <span>200 Park Avenue</span>
+          <span>Manhattan, NY 45789-3412</span>
+          <span>United States</span>
+        </address>
+        <wa-button size="small" appearance="outlined" pill>Change</wa-button>
+      </div>
+      <div class="wa-stack">
+        <h3 class="wa-heading-s">Payment Method</h3>
+        <div class="wa-flank wa-gap-s">
+          <wa-icon class="wa-body-xl" family="brands" name="cc-visa" style="color: #224DBA;"></wa-icon>
+          <span class="wa-caption-m">Visa ending in 9542</span>
+        </div>
+      </div>
+      <div class="wa-stack">
+        <h3 class="wa-heading-s">Order Summary</h3>
+        <dl class="wa-stack wa-gap-xs wa-caption-m">
+          <div class="wa-split">
+            <dt>Item(s) Subtotal</dt>
+            <dd>$39.00</dd>
+          </div>
+          <div class="wa-split">
+            <dt>Shipping & Handling</dt>
+            <dd>$0.00</dd>
+          </div>
+          <div class="wa-split">
+            <dt>Pre-tax Total</dt>
+            <dd>$39.00</dd>
+          </div>
+          <div class="wa-split">
+            <dt>Tax</dt>
+            <dd>$39.00</dd>
+          </div>
+          <wa-divider></wa-divider>
+          <div class="wa-split wa-body-m">
+            <dt>Grand Total</dt>
+            <dd>$39.00</dd>
+          </div>
+        </dl>
+      </div>
+    </div>
+  </wa-card>
+  <wa-card>
+    <div class="wa-flank:end wa-align-items-start" style="--flank-size: 12rem">
+      <div class="wa-stack">
+        <h3 class="wa-heading-s">Arriving Saturday</h3>
+        <div class="wa-flank wa-align-items-start">
+          <div class="wa-frame wa-border-radius-s">
+            <img
+              src="https://uploads.webawesome.com/sparkling-water.jpg"
+              alt=""
+            />
+          </div>
+          <div class="wa-stack">
+            <a href="" class="wa-caption-m">Mineragua Sparkling Water 12 Count</a>
+            <span class="wa-caption-s">Sold by: <a href="">Mineragua</a></span>
+            <div class="wa-cluster">
+              <span class="wa-heading-s">$39.00</span>
+              <wa-button appearance="outlined" size="small" pill>
+                <wa-icon slot="prefix" name="rotate" variant="solid"></wa-icon>
+                Buy Again
+              </wa-button>
+            </div>
+          </div>
+        </div>
+      </div>
+      <div class="wa-stack wa-gap-xs">
+        <wa-button size="small" variant="brand" pill>Track Package</wa-button>
+        <wa-button size="small" appearance="outlined" variant="neutral" pill>Cancel Item(s)</wa-button>
+        <wa-button size="small" appearance="outlined" variant="neutral" pill>Ask Question</wa-button>
+        <wa-button size="small" appearance="outlined" variant="neutral" pill>Write Review</wa-button>
+      </div>
+    </div>
+  </wa-card>
+</div>
+```
+
+## With Status & Description
+
+```html {.example}
+<div class="wa-stack wa-gap-xl">
+  <div class="wa-split">
+    <div class="wa-cluster">
+      <h2>Order #7093</h2>
+      <a href="">View Invoice</a>
+    </div>
+    <p class="wa-caption-m">Order placed <wa-format-date date="2025-06-12T09:00:00-04:00" month="long" day="numeric" year="numeric"></wa-format-date></p>
+  </div>
+  <wa-card>
+    <div class="wa-flank wa-align-items-start">
+      <div class="wa-frame wa-border-radius-s">
+        <img
+          src="https://uploads.webawesome.com/vase-1.jpg"
+          alt=""
+        />
+      </div>
+      <div class="wa-stack wa-align-items-start wa-gap-s">
+        <div class="wa-split wa-gap-s">
+          <h3 class="wa-heading-m">Spotted Flower Pot</h3>
+          <span>$75.00</span>
+        </div>
+        <p class="wa-caption-m">Wood fired, salt glaze</p>
+        <wa-tag variant="success" appearance="filled" size="small">Delivered</wa-tag>
+      </div>
+    </div>   
+  </wa-card>
+  <wa-card>
+    <div class="wa-flank wa-align-items-start">
+      <div class="wa-frame wa-border-radius-s">
+        <img
+          src="https://uploads.webawesome.com/decorative-vase.jpg"
+          alt=""
+        />
+      </div>
+      <div class="wa-stack wa-align-items-start wa-gap-s">
+        <div class="wa-split wa-gap-s">
+          <h3 class="wa-heading-m">Decorative Vase</h3>
+          <span>$51.00</span>
+        </div>
+        <p class="wa-caption-m">High quality Japanese Kutani-yaki ceramic-ware</p>
+        <wa-tag variant="neutral" appearance="filled" size="small">Shipping Soon</wa-tag>
+      </div>
+    </div>   
+  </wa-card>
+  <wa-card>
+    <div class="wa-flank wa-align-items-start">
+      <div class="wa-frame wa-border-radius-s">
+        <img
+          src="https://uploads.webawesome.com/cuong-duyen-ceramic.jpg"
+          alt=""
+        />
+      </div>
+      <div class="wa-stack wa-align-items-start wa-gap-s">
+        <div class="wa-split wa-gap-s">
+          <h3 class="wa-heading-m">Cuong Duyen Ceramic</h3>
+          <span>$48.00</span>
+        </div>
+        <p class="wa-caption-m">Koishiwara-yaki style with crystalline glaze</p>
+        <wa-tag variant="brand" appearance="filled" size="small">Out for Delivery</wa-tag>
+      </div>
+    </div>   
+  </wa-card>
+  <wa-divider></wa-divider>
+  <wa-callout variant="neutral" appearance="filled">
+    <div class="wa-grid">
+      <div class="wa-stack">
+        <h3 class="wa-heading-s">Shipping Address</h3>
+        <address class="wa-stack wa-gap-xs wa-caption-m">
+          <span>Donna Noble</span>
+          <span>56 Front Street</span>
+          <span>Las Cruces, NM 56929</span>
+        </address>
+      </div>
+      <div class="wa-stack">
+        <h3 class="wa-heading-s">Order Summary</h3>
+        <dl class="wa-stack wa-gap-xs wa-caption-m">
+          <div class="wa-split">
+            <dt>Item(s) Subtotal</dt>
+            <dd>$174.00</dd>
+          </div>
+          <div class="wa-split">
+            <dt>Shipping & Handling</dt>
+            <dd>$0.00</dd>
+          </div>
+          <div class="wa-split">
+            <dt>Tax</dt>
+            <dd>$17.40</dd>
+          </div>
+          <wa-divider></wa-divider>
+          <div class="wa-split wa-body-m">
+            <dt>Total</dt>
+            <dd>$191.40</dd>
+          </div>
+        </dl>
+      </div>
+    </div>
+  </wa-callout>
+</div>
 ```

docs/docs/patterns/ecommerce-product-detail.md

@@ -1,129 +0,0 @@
----
-title: Product Detail
-description: TODO
-parent: ecommerce
-tags: e-commerce
----
-
-TODO Page Description
-
-## With color and size selector
-```html{.example}
-  <div class="with-inline-price">
-   <wa-card with-header>
-    <div class="card-header" slot="header">
-      <span class="card-title">Graphic Tank</span>
-      <wa-icon-button name="close" label="close-modal"></wa-icon-button>
-    </div>
-    <div class="card-body">
-      <img style="border-radius: var(--border-radius)" src="/assets/images/patterns/gervyn-louis-IS03ajI00Fc-unsplash.jpg" />
-      <form class="detail">
-        <span class="price">$32</span>
-        <span class="rating"><wa-rating></wa-rating><a style="margin-left: .5rem; " href="*">36 Reviews</a></span>
-        <wa-radio-group style="margin-bottom: 1rem;" label="Select an option" name="a" value="1">
-  <wa-radio-button value="Black">Black</wa-radio-button>
-  <wa-radio-button value="White">White</wa-radio-button>
-  <wa-radio-button value="Gray">Gray</wa-radio-button>
-</wa-radio-group>
-<wa-select label="Sizes" placeholder="select size">
-  <wa-option value="option-1">Option 1</wa-option>
-  <wa-option value="option-2">Option 2</wa-option>
-  <wa-option value="option-3">Option 3</wa-option>
-</wa-select>
-<wa-button size="medium" style="width: 100%; margin-top: auto;">Medium</wa-button>
-      </form>
-    </div>
-   </wa-card>
-  </div>
-  <style>
-    .with-inline-price {
-      wa-card {
-        width: 100%;
-        .card-header {
-          display: flex;
-          justify-content: space-between;
-          align-items: center;
-
-          .card-title {
-            font-size: large;
-            font-weight: 600;
-          }
-        }
-        .card-body {
-          display: grid;
-          grid-template-columns: 35% 1fr;
-          gap: 1rem;
-
-          .detail {
-            display: flex;
-            flex-direction: column;
-
-            .price {
-              font-size: xx-large;
-              font-weight: 600;
-            }
-            .rating {
-              margin-bottom: 1rem;
-            }
-          }
-        }
-      }
-    }
-  </style>
-```
-
-## with large selector
-```html{.example}
-  <wa-card class="large-selector">
-    <div class="card-body">
-      <div style="grid-column: 1/6">
-      <img style="border-radius: var(--border-radius); height: 100%; object-fit: cover;" src="/assets/images/patterns/gervyn-louis-IS03ajI00Fc-unsplash.jpg" />
-      </div>
-      <div style="grid-column: 6/-1" class="info">
-        <h2>Basic Tank</h2>
-        <wa-icon-button name="close" label="close-modal"></wa-icon-button>
-        <section>
-          <p style="font-size: x-large;font-weight: 600;">$32</p>
-          <div style="display: flex; align-items: flex-start">
-            <p>3.9</p>
-            <wa-rating></wa-rating>
-            <a href="*" style="margin-left: auto;">See all 512 Reviews</a>
-          </div>
-        </section>
-        <section>
-          <form>
-            <wa-radio-group label="Color" hint="Choose the most appropriate option." name="a" value="black" style="margin-bottom: 1rem;">
-              <wa-radio value="black">Black</wa-radio>
-              <wa-radio value="gray">Gray</wa-radio>
-            </wa-radio-group>
-            <wa-radio-group label="Size" hint="Select an option that makes you proud." name="a" value="medium"  style="margin-bottom: 1rem;">
-              <wa-radio-button value="small">S</wa-radio-button>
-              <wa-radio-button value="medium">M</wa-radio-button>
-              <wa-radio-button value="large">L</wa-radio-button>
-              <wa-radio-button value="extra-large">XL</wa-radio-button>
-            </wa-radio-group>
-            <wa-button size="medium" style="width: 100%; margin-top: auto;margin-bottom: 1rem;">Medium</wa-button>
-            <a href="*" style="display: inline-block;width: 100%;text-align: center;">View full details</a>
-          </form>
-        </section>
-      </div>
-    </div>
-  </wa-card>
-<style>
-  .large-selector .card-body {
-    display: grid;
-    grid-template-columns: repeat(12, 1fr);
-    gap: 1rem;
-
-    .info {
-      position: relative;
-
-      wa-icon-button {
-        position: absolute;
-        top: 0;
-        right: 0;
-      }
-    }
-  }
-</style>
-```

docs/docs/patterns/ecommerce-product-list.md

@@ -1,166 +1,184 @@
 ---
 title: Product Lists
-description: TODO
+description: 'Let shoppers browse and compare products with detailed lists of the products in your store.'
 parent: ecommerce
 tags: e-commerce
 ---
 
-TODO Page Description
-## With Product Grid
+## Simple Grid with Ratings
 
-```html{.example}
-  <div class="with-product-grid">
-    <div class="grid-item">
-      <img class="grid-item-image" src="/assets/images/patterns/mad-rabbit-tattoo-7N4FMowSGek-unsplash.jpg" />
-      <div class="grid-item-name">Shirt</div>
-      <wa-rating label="Rating" readonly value="3"></wa-rating>
-      <a class="grid-item-reviews" href="#">38 Reviews</a>
-      <div class="grid-item-price">$170</div>
+```html {.example}
+<div class="wa-grid wa-gap-2xl">
+  <a class="wa-stack wa-align-items-center wa-gap-xs wa-link-plain" href="">
+    <div class="wa-frame wa-border-radius-m">
+      <img 
+        src="https://images.unsplash.com/photo-1633933329864-5d4c4423ad54?q=80&w=3387&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Bunch of fresh basil leaves with purple veins (Photograph by Svitlana)"
+      />
     </div>
-    <div class="grid-item">
-      <img class="grid-item-image" src="/assets/images/patterns/mad-rabbit-tattoo-7N4FMowSGek-unsplash.jpg" />
-      <div class="grid-item-name">Shirt</div>
-      <wa-rating label="Rating" readonly value="3"></wa-rating>
-      <a class="grid-item-reviews" href="#">38 Reviews</a>
-      <div class="grid-item-price">$170</div>
+    <strong>Basil</strong>
+    <wa-rating label="Rating" size="small" readonly value="5"></wa-rating>
+    <span class="wa-caption-m">41 Reviews</span>
+    <strong>$8.59</strong>
+  </a>
+  <a class="wa-stack wa-align-items-center wa-gap-xs wa-link-plain" href="">
+    <div class="wa-frame wa-border-radius-m">
+      <img 
+        src="https://images.unsplash.com/photo-1662892194342-f95c33cc16e3?q=80&w=3000&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Bunch of cut chamomile blooms (Photograph by Rootnot Creations)"
+      />
     </div>
-    <div class="grid-item">
-      <img class="grid-item-image" src="/assets/images/patterns/mad-rabbit-tattoo-7N4FMowSGek-unsplash.jpg" />
-      <div class="grid-item-name">Shirt</div>
-      <wa-rating label="Rating" readonly value="3"></wa-rating>
-      <a class="grid-item-reviews" href="#">38 Reviews</a>
-      <div class="grid-item-price">$170</div>
+    <strong>Chamomile</strong>
+    <wa-rating label="Rating" size="small" readonly value="3"></wa-rating>
+    <span class="wa-caption-m">17 Reviews</span>
+    <strong>$10.29</strong>
+  </a>
+  <a class="wa-stack wa-align-items-center wa-gap-xs wa-link-plain" href="">
+    <div class="wa-frame wa-border-radius-m">
+      <img 
+        src="https://images.unsplash.com/photo-1636396279461-f875646332d9?q=80&w=3360&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Canvas bundle of cut lavender blooms (Photograph by volant)"
+      />
     </div>
-    <div class="grid-item">
-      <img class="grid-item-image" src="/assets/images/patterns/mad-rabbit-tattoo-7N4FMowSGek-unsplash.jpg" />
-      <div class="grid-item-name">Shirt</div>
-      <wa-rating label="Rating" readonly value="3"></wa-rating>
-      <a class="grid-item-reviews" href="#">38 Reviews</a>
-      <div class="grid-item-price">$170</div>
+    <strong>Lavender</strong>
+    <wa-rating label="Rating" size="small" readonly value="4"></wa-rating>
+    <span class="wa-caption-m">29 Reviews</span>
+    <strong>$9.99</strong>
+  </a>
+  <a class="wa-stack wa-align-items-center wa-gap-xs wa-link-plain" href="">
+    <div class="wa-frame wa-border-radius-m">
+      <img 
+        src="https://images.unsplash.com/photo-1501085934018-450c8e615dbc?q=80&w=3387&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Blooming marjoram plant (Photograph by Monika Grabkowska)"
+      />
     </div>
+    <strong>Marjoram</strong>
+    <wa-rating label="Rating" size="small" readonly value="4"></wa-rating>
+    <span class="wa-caption-m">11 Reviews</span>
+    <strong>$8.59</strong>
+  </a>
+  <a class="wa-stack wa-align-items-center wa-gap-xs wa-link-plain" href="">
+    <div class="wa-frame wa-border-radius-m">
+      <img 
+        src="https://images.unsplash.com/photo-1688633767797-455f59c98272?q=80&w=3540&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Group of mature oregano plants (Photograph Nikolett Emmert)"
+      />
+    </div>
+    <strong>Oregano</strong>
+    <wa-rating label="Rating" size="small" readonly value="5"></wa-rating>
+    <span class="wa-caption-m">38 Reviews</span>
+    <strong>$8.59</strong>
+  </a>
+  <a class="wa-stack wa-align-items-center wa-gap-xs wa-link-plain" href="">
+    <div class="wa-frame wa-border-radius-m">
+      <img 
+        src="https://images.unsplash.com/photo-1603109731710-dba41b1096a7?q=80&w=2259&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Cluster of peppermint plants (Photograph by Josefin)"
+      />
+    </div>
+    <strong>Peppermint</strong>
+    <wa-rating label="Rating" size="small" readonly value="5"></wa-rating>
+    <span class="wa-caption-m">26 Reviews</span>
+    <strong>$9.99</strong>
+  </a>
+  <a class="wa-stack wa-align-items-center wa-gap-xs wa-link-plain" href="">
+    <div class="wa-frame wa-border-radius-m">
+      <img 
+        src="https://images.unsplash.com/photo-1726994803809-0e065bd4b25b?q=80&w=3387&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Mature rosemary stems (Photograph by 360floralflaves)"
+      />
+    </div>
+    <strong>Rosemary</strong>
+    <wa-rating label="Rating" size="small" readonly value="4"></wa-rating>
+    <span class="wa-caption-m">34 Reviews</span>
+    <strong>$8.59</strong>
+  </a>
+  <a class="wa-stack wa-align-items-center wa-gap-xs wa-link-plain" href="">
+    <div class="wa-frame wa-border-radius-m">
+      <img 
+        src="https://images.unsplash.com/photo-1659834742696-44573974981b?q=80&w=3542&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Group of sage plants (Photograph by Susie Burleson)"
+      />
+    </div>
+    <strong>Sage</strong>
+    <wa-rating label="Rating" size="small" readonly value="5"></wa-rating>
+    <span class="wa-caption-m">24 Reviews</span>
+    <strong>$9.29</strong>
+  </a>
+</div>
+```
+
+## Even Card Grid with Details
+
+```html {.example}
+<div class="wa-grid" style="--min-column-size: 50ch">
+  <div class="wa-grid">
+    <a href="" class="wa-link-plain">
+      <wa-card>
+        <img slot="image" 
+          src="https://images.unsplash.com/photo-1622445272461-c6580cab8755?q=80&w=3387&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+          alt="Man in a relaxed fit, white, crew neck t-shirt (Photography by Mediamodifier)"
+        />
+        <div class="wa-stack">
+          <div class="wa-flank:end wa-align-items-start wa-heading-m">
+            <span>Plain Classic Tee</span>
+            <span>$24</span>
+          </div>
+          <p class="wa-caption-m">Keep it casual or dress it up. Soft, 100% cotton with a crew neckline, perfect for any occasion.</p>
+          <em class="wa-caption-m">8 colors</em>
+        </div>
+      </wa-card>
+    </a>
+    <a href="" class="wa-link-plain">
+      <wa-card>
+        <img slot="image" 
+          src="https://images.unsplash.com/photo-1554568218-0f1715e72254?q=80&w=3387&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+          alt="Woman in a light heather t-shirt printed with sharp black ink (Photograph by Christian Bolt)"
+        />
+        <div class="wa-stack">
+          <div class="wa-flank:end wa-align-items-start wa-heading-m">
+            <span>One-color Graphic Tee</span>
+            <span>$32</span>
+          </div>
+          <p class="wa-caption-m">Your own spin on our classic tee. Hand screen printed for the ultimate accuracy and quality.</p>
+          <em class="wa-caption-m">6 colors</em>
+        </div>
+      </wa-card>
+    </a>
   </div>
-  <style>
-    .with-product-grid {
-      display: grid;
-      grid-template-columns: repeat(2, 1fr);
-      border: var(--wa-panel-border-width) var(--wa-border-style) var(--wa-color-neutral-border-quiet);
-
-      .grid-item {
-        padding: 1.5rem;
-        display: flex;
-        flex-direction: column;
-        justify-content: center;
-        align-items: center;
-      }
-      .grid-item:nth-of-type(odd) {
-
-        border-right: var(--wa-panel-border-width) var(--wa-border-style) var(--wa-color-neutral-border-quiet);
-      }
-      .grid-item:not(:nth-last-child(-n + 2)) {
-        border-bottom: var(--wa-panel-border-width) var(--wa-border-style) var(--wa-color-neutral-border-quiet);
-      }
-
-      .grid-item-image {
-        width: 100%;
-        object-fit: cover;
-      }
-
-      .grid-item-name {
-        margin-top: 1rem;
-        font-weight: var(--wa-font-weight-bold);
-      }
-
-      .grid-item wa-rating {
-        --symbol-size: var(--wa-font-size-m);
-        margin-top: .5rem;
-      }
-      .grid-item-reviews {
-        --wa-link-decoration-default: none;
-        --wa-color-text-link: var(--wa-color-gray-50);
-        font-size: var(--wa-font-size-m);
-      }
-      .grid-item-price {
-        font-size: var(--wa-font-size-2xl);
-        font-weight: var(--wa-font-weight-bold);
-      }
-    }
-  </style>
-```
-## Card with full details
-```html{.example}
-  <div class="card-with-details">
-   <wa-card with-footer>
-    <img class="grid-item-image" src="/assets/images/patterns/mad-rabbit-tattoo-7N4FMowSGek-unsplash.jpg" />
-    <div slot="footer" class="card-footer details">
-      <span class="detail-name">Basic Tee 8-pack</span>
-      <p class="detail-description">Get the full lineup of our Basic Tees. Have a fresh shirt all week, and an extra for laundry day.</p>
-      <span class="detail-color">8 colors</span>
-      <span class="detail-price">$256</span>
-    </div>
-   </wa-card>
-   <wa-card with-footer>
-    <img class="grid-item-image" src="/assets/images/patterns/mad-rabbit-tattoo-7N4FMowSGek-unsplash.jpg" />
-    <div slot="footer" class="card-footer details">
-      <span class="detail-name">Basic Tee 8-pack</span>
-      <p class="detail-description">Get the full lineup of our Basic Tees. Have a fresh shirt all week, and an extra for laundry day.</p>
-      <span class="detail-color">8 colors</span>
-      <span class="detail-price">$256</span>
-    </div>
-   </wa-card>
-   <wa-card with-footer>
-    <img class="grid-item-image" src="/assets/images/patterns/mad-rabbit-tattoo-7N4FMowSGek-unsplash.jpg" />
-    <div slot="footer" class="card-footer details">
-      <span class="detail-name">Basic Tee 8-pack</span>
-      <p class="detail-description">Get the full lineup of our Basic Tees. Have a fresh shirt all week, and an extra for laundry day.</p>
-      <span class="detail-color">8 colors</span>
-      <span class="detail-price">$256</span>
-    </div>
-   </wa-card>
-   <wa-card with-footer>
-    <img class="grid-item-image" src="/assets/images/patterns/mad-rabbit-tattoo-7N4FMowSGek-unsplash.jpg" />
-    <div slot="footer" class="card-footer details">
-      <span class="detail-name">Basic Tee 8-pack</span>
-      <p class="detail-description">Get the full lineup of our Basic Tees. Have a fresh shirt all week, and an extra for laundry day.</p>
-      <span class="detail-color">8 colors</span>
-      <span class="detail-price">$256</span>
-    </div>
-   </wa-card>
+  <div class="wa-grid">
+    <a href="" class="wa-link-plain">
+      <wa-card>
+        <img slot="image"
+          src="https://images.unsplash.com/photo-1567098260939-5d9cee055592?q=80&w=2832&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+          alt="Man in a black t-shirt printed with many-colored gradients (Photograph by Marcel)"
+        />
+        <div class="wa-stack">
+          <div class="wa-flank:end wa-align-items-start wa-heading-m">
+            <span>Multi-color Graphic Tee</span>
+            <span>$36</span>
+          </div>
+          <p class="wa-caption-m">Make a statement. Screen printed with vibrant, quality inks to last wash after wash.</p>
+          <em class="wa-caption-m">4 colors</em>
+        </div>
+      </wa-card>
+    </a>
+    <a href="" class="wa-link-plain">
+      <wa-card>
+        <img slot="image"
+          src="https://images.unsplash.com/photo-1709185727063-c3caae752a64?q=80&w=3387&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+          alt="Woman in a black t-shirt with a bright white logo printed on the pocket (Photograph by SASI)"
+        />
+        <div class="wa-stack">
+          <div class="wa-flank:end wa-align-items-start wa-heading-m">
+            <span>Pocket Graphic Tee</span>
+            <span>$29</span>
+          </div>
+          <p class="wa-caption-m">Go classic with a bit of your own flair. Screen printed, eye-catching detail on the pocket.</p>
+          <em class="wa-caption-m">6 colors</em>
+        </div>
+      </wa-card>
+    </a>
   </div>
-  <style>
-    .card-with-details {
-      display: grid;
-      grid-template-columns: repeat(2, 1fr);
-      gap: 1rem;
-    }
-    .card-with-details wa-card::part(body) {
-        padding: 0;
-      }
-    .card-with-details .card-footer {
-      display: flex;
-      flex-direction: column;
-    }
-
-    .details {
-      .detail-description {
-        color: var(--wa-color-gray-50);
-      }
-      .detail-name {
-        font-size: var(--wa-font-size-l);
-        font-weight: var(--wa-font-weight-action);
-      }
-      .detail-color {
-        color: var(--wa-color-gray-50);
-        font-style: italic;
-      }
-      .detail-price {
-        font-size: var(--wa-font-size-xl);
-        font-weight: var(--wa-font-weight-action);
-      }
-    }
-
-  </style>
-```
-## With color swatches (WIP)
-```html{.example}
-
-```
+</div>
+```

docs/docs/patterns/ecommerce-product-overview.md

@@ -0,0 +1,431 @@
+---
+title: Product Overview
+description: 'Showcase your products with overviews including images, ratings, features, options, and more.'
+parent: ecommerce
+tags: e-commerce
+---
+
+## Split with Image
+
+```html {.example}
+<div class="wa-grid wa-gap-2xl">
+  <div class="wa-stack wa-gap-2xl">
+    <h2>San Ignacio Pache</h2>
+    <p>A smooth, balanced Arabica varietal, grown and roasted on the Guerrero family's farm. Rich caramel and malt flavors blend with bright citrus for a complex brew suitable for drip, pour over, espresso, or however you take your coffee.</p>
+    <div class="wa-stack">
+      <wa-select label="Bag Size" value="12oz">
+        <wa-option value="12oz">12 oz &ndash; $19.95</wa-option>
+        <wa-option value="3lb">3 lb &ndash; $72.00</wa-option>
+        <wa-option value="5lb">5 lb &ndash; $99.75</wa-option>
+      </wa-select>
+      <wa-select label="Bean Type" value="whole">
+        <wa-option value="whole">Whole</wa-option>
+        <wa-option value="drip">Drip Grind</wa-option>
+        <wa-option value="espresso">Espresso Grind</wa-option>
+      </wa-select>
+    </div>
+    <div class="wa-stack">
+      <div class="wa-flank">
+        <wa-input type="number" aria-label="Quantity" value="1" min="1" style="max-width: 8ch"></wa-input>
+        <wa-button variant="brand">
+          <wa-icon slot="prefix" name="basket-shopping"></wa-icon>
+          Add to Basket
+        </wa-button>
+      </div>
+      <div class="wa-flank wa-caption-m">
+        <wa-icon name="truck"></wa-icon>
+        <span>Free shipping on orders over $60</span>
+      </div>
+    </div>
+    <dl class="wa-grid">
+      <div class="wa-flank">
+        <wa-avatar>
+          <wa-icon slot="icon" name="coffee-bean"></wa-icon>
+        </wa-avatar>
+        <div class="wa-stack wa-gap-0">
+          <dt>Roast</dt>
+          <dd>Medium</dd>
+        </div>
+      </div>
+      <div class="wa-flank">
+        <wa-avatar>
+          <wa-icon slot="icon" name="earth-americas"></wa-icon>
+        </wa-avatar>
+        <div class="wa-stack wa-gap-0">
+          <dt>Origin</dt>
+          <dd>San Ignacio, Peru</dd>
+        </div>
+      </div>
+      <div class="wa-flank">
+        <wa-avatar>
+          <wa-icon slot="icon" name="sun-haze"></wa-icon>
+        </wa-avatar>
+        <div class="wa-stack wa-gap-0">
+          <dt>Process</dt>
+          <dd>Washed</dd>
+        </div>
+      </div>
+      <div class="wa-flank">
+        <wa-avatar>
+          <wa-icon slot="icon" name="mug-hot"></wa-icon>
+        </wa-avatar>
+        <div class="wa-stack wa-gap-0">
+          <dt>Tasting Notes</dt>
+          <dd>Caramel, malt, orange</dd>
+        </div>
+      </div>
+    </dl>
+  </div>
+  <div class="wa-frame wa-border-radius-m">
+    <img 
+      src="https://images.unsplash.com/photo-1600396538702-d234dbb79139?q=80&w=3833&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+      alt="Whole roasted coffee beans (Photograph by Jocelyn Morales)"
+    />
+  </div>
+</div>
+```
+
+## With Image Grid
+
+```html {.example}
+<div class="wa-stack wa-gap-2xl">
+  <wa-breadcrumb>
+    <wa-breadcrumb-item>Clothing</wa-breadcrumb-item>
+    <wa-breadcrumb-item>Women's</wa-breadcrumb-item>
+    <wa-breadcrumb-item>Shirts &amp; Tops</wa-breadcrumb-item>
+  </wa-breadcrumb>
+  <div class="wa-grid wa-gap-xs" style="--min-column-size: 10ch">
+    <div class="wa-frame" style="height: 100%; width: 100%">
+      <img class="wa-border-radius-s"
+        src="https://images.unsplash.com/photo-1614792568992-ded1c487c1dd?q=80&w=2487&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="(Photograph by Patrick Perkins)"
+      />
+    </div>
+    <div class="wa-grid wa-gap-xs">
+      <div class="wa-frame" style="aspect-ratio: 3 / 2">
+        <img class="wa-border-radius-s"
+          src="https://images.unsplash.com/photo-1614725078749-29c421fd0e51?q=80&w=2487&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+          alt="(Photograph by Patrick Perkins)"
+        />
+      </div>
+      <div class="wa-frame" style="aspect-ratio: 3 / 2">
+        <img class="wa-border-radius-s"
+          src="https://images.unsplash.com/photo-1614725808713-e6bbe418fc5d?q=80&w=2487&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+          alt="(Photograph by Patrick Perkins)"
+        />
+      </div>
+    </div>
+    <div class="wa-frame" style="height: 100%; width: 100%">
+      <img class="wa-border-radius-s"
+        src="https://images.unsplash.com/photo-1614725078379-9d1330a08c95?q=80&w=2487&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="(Photograph by Patrick Perkins)"
+      />
+    </div>
+  </div>
+  <div class="wa-grid wa-gap-xl" style="--min-column-size: 30ch">
+    <h2 class="wa-heading-l">Cropped Fitted Tank Top</h2>
+    <span class="wa-body-xl">$59</span>
+  </div>
+  <div class="wa-grid wa-gap-xl" style="--min-column-size: 30ch">
+    <div class="wa-stack wa-gap-xl">
+      <div class="wa-cluster">
+        <wa-rating label="Rating" readonly value="3.5"></wa-rating>
+        <a href="">117 Reviews</a>
+      </div>
+      <p>Made with a breathable, stretchy fabric blend for unparalleled comfort and flattering style. Pairs perfectly with your favorite high-waisted jeans for lazy summer weekends or lively nights out.</p>
+      <div class="wa-stack wa-gap-xs">
+        <h3 class="wa-heading-xs">Good to Know</h3>
+        <p class="wa-body-xs">95% cotton, 5% elastane. Our tops are pre-shrunk to ensure a consistent fit with no surprises. Machine wash cold. Tumble dry low.</p>
+      </div>
+    </div>
+    <div class="wa-stack">
+      <wa-radio-group label="Color" name="color" value="black" orientation="horizontal">
+        <wa-radio-button id="radio-black" value="black">
+          <wa-icon name="square" label="Black" style="color: black;"></wa-icon>
+          <wa-tooltip for="radio-black">Black</wa-tooltip>
+        </wa-radio-button>
+        <wa-radio-button id="radio-gray" value="gray">
+          <wa-icon name="square" label="Gray" style="color: gray;"></wa-icon>
+          <wa-tooltip for="radio-gray">Gray</wa-tooltip>
+        </wa-radio-button>
+        <wa-radio-button id="radio-indigo" value="indigo">
+          <wa-icon name="square" label="Indigo" style="color: indigo;"></wa-icon>
+          <wa-tooltip for="radio-indigo">Indigo</wa-tooltip>
+        </wa-radio-button>
+        <wa-radio-button id="radio-olive" value="olive">
+          <wa-icon name="square" label="Olive" style="color: olive;"></wa-icon>
+          <wa-tooltip for="radio-olive">Olive</wa-tooltip>
+        </wa-radio-button>
+      </wa-radio-group>
+      <wa-radio-group label="Size" name="size" value="s" orientation="horizontal">
+        <wa-radio-button value="xs">XS</wa-radio-button>
+        <wa-radio-button value="s">S</wa-radio-button>
+        <wa-radio-button value="m">M</wa-radio-button>
+        <wa-radio-button value="l">L</wa-radio-button>
+        <wa-radio-button value="xl">XL</wa-radio-button>
+      </wa-radio-group>
+      <wa-button variant="brand">
+        <wa-icon slot="prefix" name="cart-plus" variant="solid"></wa-icon>
+        Add to Cart
+      </wa-button>
+    </div>
+  </div>
+</div>
+```
+
+## With Tiered Images
+
+```html {.example}
+<div class="wa-stack wa-gap-2xl">
+  <wa-breadcrumb>
+    <wa-breadcrumb-item>Clothing</wa-breadcrumb-item>
+    <wa-breadcrumb-item>Men's</wa-breadcrumb-item>
+    <wa-breadcrumb-item>Shirts &amp; Tops</wa-breadcrumb-item>
+  </wa-breadcrumb>
+  <div class="wa-grid wa-gap-2xl" style="--min-column-size: 35ch">
+    <div class="wa-stack wa-gap-xs">
+      <img class="wa-border-radius-s"
+        src="https://images.unsplash.com/photo-1630643583573-c68623718072?q=80&w=3387&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="(Photograph by Gervyn Louis)"
+      />
+      <div class="wa-grid wa-gap-xs" style="--min-column-size: 0ch">
+        <img class="wa-border-radius-s"
+          src="https://images.unsplash.com/photo-1571666274590-f8cc87006500?q=80&w=3387&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+          alt="(Photograph by Gervyn Louis)"
+        />
+        <img class="wa-border-radius-s"
+          src="https://images.unsplash.com/photo-1630643591760-a6ed60ef499f?q=80&w=3387&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+          alt="(Photograph by Gervyn Louis)"
+        />
+      </div>
+    </div>
+    <div class="wa-stack">
+      <div class="wa-split">
+        <h2 class="wa-heading-l">Graphic Cutoff Tee</h2>
+        <span class="wa-body-xl">$65</span>
+      </div>
+      <div class="wa-split">
+        <div class="wa-cluster">
+          <wa-rating label="Rating" readonly value="4.2"></wa-rating>
+          <span>4.2</span>
+        </div>
+        <a href="#">144 Reviews</a>
+      </div>
+      <wa-radio-group label="Color" name="color" value="black" orientation="horizontal">
+        <wa-radio-button value="black">
+          <wa-icon slot="prefix" name="shirt" style="color: black;"></wa-icon>
+          Vintage Black
+        </wa-radio-button>
+        <wa-radio-button value="gray">
+          <wa-icon slot="prefix" name="shirt" style="color: gray;"></wa-icon>
+          Faded Gray
+        </wa-radio-button>
+      </wa-radio-group>
+      <wa-radio-group label="Size" name="size" value="s" orientation="horizontal">
+        <wa-radio-button value="xs">XS</wa-radio-button>
+        <wa-radio-button value="s">S</wa-radio-button>
+        <wa-radio-button value="m">M</wa-radio-button>
+        <wa-radio-button value="l">L</wa-radio-button>
+        <wa-radio-button value="xl">XL</wa-radio-button>
+      </wa-radio-group>
+      <wa-button variant="brand">
+        <wa-icon slot="prefix" name="bag-shopping" variant="solid"></wa-icon>
+        Add to Bag
+      </wa-button>
+      <wa-divider></wa-divider>
+      <h3 class="wa-heading-s">Description</h3>
+      <p>Stay cool, <em>slay</em> cool. Train hard and recover in style with this ultra-breathable cutoff tee. Made from 100% organic, quick-drying cotton to keep the air flowing whether you're lifting, sprinting, or crushing HIIT sessions.</p>
+      <wa-divider></wa-divider>
+      <h3 class="wa-heading-s">Highlights</h3>
+      <div class="wa-grid">
+        <wa-card class="wa-span-grid">
+          <div class="wa-stack">
+            <wa-icon name="hand-holding-heart"></wa-icon>
+            <h4 class="wa-heading-s">People and Planet First</h4>
+            <p class="wa-caption-m">Ethical production, fair wages, and sustainable materials empower every part of our supply chain.</p>
+          </div>
+        </wa-card>
+        <wa-card>
+          <div class="wa-stack">
+            <wa-icon name="earth-americas"></wa-icon>
+            <h4 class="wa-heading-s">International Shipping</h4>
+            <p class="wa-caption-m">Wherever you are, your order will meet you there.</p>
+          </div>
+        </wa-card>
+        <wa-card>
+          <div class="wa-stack">
+            <wa-icon name="arrow-right-arrow-left"></wa-icon>
+            <h4 class="wa-heading-s">90-day Returns</h4>
+            <p class="wa-caption-m">Not happy? Return your item and get a full refund.</p>
+          </div>
+        </wa-card>
+      </div>
+    </div>
+  </div>
+</div>
+```
+
+## With Carousel and Collapsible Details
+
+```html {.example}
+<div class="wa-stack wa-gap-2xl">
+  <wa-carousel pagination navigation loop style="--aspect-ratio: 3 / 2;">
+    <wa-carousel-item>
+      <img
+        src="https://images.unsplash.com/photo-1601379327928-bedfaf9da2d0?q=80&w=3456&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Four folded and stacked knit sweaters in three colors (Photograph by Tijana Drndarski)"
+      />
+    </wa-carousel-item>
+    <wa-carousel-item>
+      <img
+        src="https://images.unsplash.com/photo-1519804270019-39e929a7afb5?q=80&w=3774&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Knit sweater in sand color full view, showing waffle knit pattern, relaxed fit, and crew neckline (Photograph by Jonathan Zerger)"
+      />
+    </wa-carousel-item>
+    <wa-carousel-item>
+      <img
+        src="https://images.unsplash.com/photo-1519805614447-6f49142e6697?q=80&w=3633&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Knit sweater in sand color shoulder detail, showing relaxed fit on broader shoulders (Photograph by Jonathan Zerger)"
+      />
+    </wa-carousel-item>
+    <wa-carousel-item>
+      <img
+        src="https://images.unsplash.com/photo-1522230130022-498e355165c5?q=80&w=3774&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Knit sweater in sand color sleeve detail, showing loose fit around the arms (Photograph by Jonathan Zerger)"
+      />
+    </wa-carousel-item>
+  </wa-carousel>
+  <div class="wa-grid wa-gap-2xl" style="--min-column-size: 30ch;">
+    <div class="wa-stack">
+      <div class="wa-split">
+        <h3>Pullover Sweater</h3>
+        <span class="wa-body-xl">$140</span>
+      </div>
+      <wa-rating label="Rating" precision="0.5" value="4.5" readonly></wa-rating>
+      <p>Wrap yourself in warmth and effortless style with this wool knit Pullover Sweater. Designed for unparalleled comfort. The relaxed fit and classic crew neckline make it a versatile staple for layering or wearing solo.</p>
+      <wa-radio-group label="Color" name="color" value="sand" orientation="horizontal">
+        <wa-radio-button value="sand">
+          <wa-icon slot="prefix" name="circle" style="color: burlywood;"></wa-icon>
+          Sand
+        </wa-radio-button>
+        <wa-radio-button value="shale">
+          <wa-icon slot="prefix" name="circle" style="color: silver;"></wa-icon>
+          Shale
+        </wa-radio-button>
+        <wa-radio-button value="slate">
+          <wa-icon slot="prefix" name="circle" style="color: dimgray;"></wa-icon>
+          Slate
+        </wa-radio-button>
+      </wa-radio-group>
+      <wa-radio-group label="Size" name="size" value="s" orientation="horizontal">
+        <wa-radio-button value="xs">XS</wa-radio-button>
+        <wa-radio-button value="s">S</wa-radio-button>
+        <wa-radio-button value="m">M</wa-radio-button>
+        <wa-radio-button value="l">L</wa-radio-button>
+        <wa-radio-button value="xl">XL</wa-radio-button>
+      </wa-radio-group>
+      <wa-button variant="brand">Add to Cart</wa-button>
+    </div>
+    <div class="wa-stack">
+      <wa-details summary="Size and Fit" open>
+        <ul class="wa-body-s">
+          <li>True to size with a relaxed fit</li>
+          <li>Fits all shoulder shapes, broad to narrow</li>
+          <li>No pinching in the arms or irritating seams</li>
+          <li>Ribbed cuffs and hem</li>
+        </ul>
+      </wa-details>
+      <wa-details summary="Materials and Care">
+        <ul class="wa-body-s">
+          <li>Durable Merino and Yak wool blend</li>
+          <li>Machine wash cold on delicate cycle</li>
+          <li>Lay flat to dry</li>
+          <li>Made with <wa-icon name="heart" label="love"></wa-icon> in Bentonville, USA</li>
+        </ul>
+      </wa-details>
+      <wa-details summary="Shipping">
+        <ul class="wa-body-s">
+          <li>Flat $9 shipping free for orders under $200.</li>
+          <li>Free shipping on orders over $200, anywhere in the world.</li>
+        </ul>
+      </wa-details>
+    </div>
+  </div>
+</div>
+```
+
+
+## With Tabs
+
+```html {.example}
+<div class="wa-flank:end wa-align-items-start wa-gap-2xl" style="--flank-size: 30ch">
+  <div class="wa-stack">
+    <img class="wa-border-radius-l"
+      src="https://img.fortawesome.com/cfa83f3c/icon-grid-wallpaper.png"
+      alt="Sample of 48 line-style icons" 
+    />
+    <wa-tab-group>
+      <wa-tab panel="license">License</wa-tab>
+      <wa-tab panel="faq">FAQ</wa-tab>
+      <wa-tab-panel name="license">
+        <p class="wa-body-s">Your purchase includes a perpetual Font Awesome Pro License to use Classic Light icons on unlimited projects. <a href="">Read the full license terms.</a></p>
+      </wa-tab-panel>
+      <wa-tab-panel name="faq">
+        <dl class="wa-stack wa-body-s">
+          <dt>Do I need to renew my subscription to receive fixes?</dt>
+          <dd>We split up Font Awesome releases into regular updates and bug-fix updates. With a Font Awesome Pro plan that has a perpetual license, you'll always be entitled to bug-fix updates for your last version, even after your subscription has expired.</dd>
+          <dt>Can I use Font Awesome Pro in themes, plug-ins, or open source projects?</dt>
+          <dd>For themes and open source projects, right now it's best to just use Font Awesome Free. We are working a better solution, so feel free to get in touch if you have thoughts.</dd>
+          <dt>Do you offer enterprise licenses for Font Awesome Pro?</dt>
+          <dd>We don't currently offer Enterprise-level licenses, but we may do so in the future. Get in touch if interested.</dd>
+        </dl>
+      </wa-tab-panel>
+    </wa-tab-group>
+  </div>
+  <div class="wa-stack wa-gap-l">
+    <wa-badge appearance="filled">Sale</wa-badge>
+    <h2>Icon Pack: Classic Light</h2>
+    <p class="wa-body-l">Easy, readable icons with a lighter touch.</p>
+    <div class="wa-cluster wa-gap-xs wa-body-l">
+      <s>$60</s>
+      <strong>$49</strong>
+    </div>
+    <wa-button variant="brand" size="large">
+      <wa-icon slot="prefix" name="arrow-down-to-line" variant="solid"></wa-icon>
+      Get Icons
+    </wa-button>
+    <wa-divider></wa-divider>
+    <h3 class="wa-heading-m">What's in the Pack</h3>
+      <ul class="wa-stack wa-gap-xs">
+        <li class="wa-flank">
+          <wa-icon name="badge-check"></wa-icon>
+          <span>3,323 icons</span>
+        </li>
+        <li class="wa-flank">
+          <wa-icon name="badge-check"></wa-icon>
+          <span>Pre-bundled Font Awesome kit</span>
+        </li>
+        <li class="wa-flank">
+          <wa-icon name="badge-check"></wa-icon>
+          <span>Ligature-based desktop font files</span>
+        </li>
+        <li class="wa-flank">
+          <wa-icon name="badge-check"></wa-icon>
+          <span>Individual SVGs + SVG sprites</span>
+        </li>
+        <li class="wa-flank">
+          <wa-icon name="badge-check"></wa-icon>
+          <span>Web fonts + SVG framework</span>
+        </li>
+        <li class="wa-flank">
+          <wa-icon name="badge-check"></wa-icon>
+          <span>SCSS/LESS CSS preprocessor files</span>
+        </li>
+        <li class="wa-flank">
+          <wa-icon name="badge-check"></wa-icon>
+          <span>Perpetual Pro license</span>
+        </li>
+      </ul>
+  </div>
+</div>
+```

docs/docs/patterns/ecommerce-product-preview.md

@@ -0,0 +1,162 @@
+---
+title: Product Preview
+description: 'Give shoppers a quick look at your products as they browse with modal previews.'
+parent: ecommerce
+tags: e-commerce
+icon: preview
+---
+ 
+## With Product Options
+
+```html {.example}
+<wa-card with-header>
+  <div class="wa-split" slot="header">
+    <h3 class="wa-heading-l">Stan Smith® Camo Tongue Tee</h3>
+    <wa-icon-button name="close" label="Close Preview"></wa-icon-button>
+  </div>
+  <div class="wa-grid wa-gap-xl">
+    <div class="wa-frame wa-border-radius-l" style="aspect-ratio: auto">
+      <img 
+        src="https://images.unsplash.com/photo-1660997351262-6c31d8a35b6c?q=80&w=2000&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Stan Smith graphic crew-neck tee in honeydew color"
+      />
+    </div>
+    <div class="wa-split:column wa-align-items-stretch wa-gap-xl">
+      <div class="wa-stack wa-gap-xl">
+        <div class="wa-cluster">
+        <span class="wa-heading-2xl">$32</span>
+          <wa-divider vertical style="height: 2em"></wa-divider>
+          <wa-rating label="Rating" value="3.75" readonly></wa-rating>
+          <a href="" class="wa-caption-m">36 Reviews</a>
+        </div>
+        <p>An ode to the “Sneaker that go with everything” …even this tee.</p>
+        <wa-divider></wa-divider>
+        <div class="wa-stack wa-gap-s">
+          <h4 class="wa-heading-s">Categories</h4>
+          <div class="wa-cluster wa-gap-2xs">
+            <a href=""><wa-tag appearance="outlined" size="small" pill>Men's</wa-tag></a>
+            <a href=""><wa-tag appearance="outlined" size="small" pill>Sneakers</wa-tag></a>
+            <a href=""><wa-tag appearance="outlined" size="small" pill>Tees</wa-tag></a>
+            <a href=""><wa-tag appearance="outlined" size="small" pill>Lifestyle</wa-tag></a>
+            <a href=""><wa-tag appearance="outlined" size="small" pill>Fashion</wa-tag></a>
+            <a href=""><wa-tag appearance="outlined" size="small" pill>Casual</wa-tag></a>
+            <a href=""><wa-tag appearance="outlined" size="small" pill>Stan Smith</wa-tag></a>
+            <a href=""><wa-tag appearance="outlined" size="small" pill>Tennis</wa-tag></a>
+            <a href=""><wa-tag appearance="outlined" size="small" pill>Sports</wa-tag></a>
+          </div>
+        </div>
+        <wa-divider></wa-divider>
+        <div class="wa-stack wa-gap-s">
+          <wa-select label="Color" value="honeydew">
+            <wa-option value="hotpink">
+              <wa-icon slot="prefix" name="circle" style="color: hotpink;"></wa-icon>
+              Hot Pink
+            </wa-option>
+            <wa-option value="honeydew">
+              <wa-icon slot="prefix" name="circle" style="color: honeydew;"></wa-icon>
+              Honeydew
+            </wa-option>
+            <wa-option value="coral">
+              <wa-icon slot="prefix" name="circle" style="color: lightcoral;"></wa-icon>
+              Coral
+            </wa-option>
+            <wa-option value="wheat">
+              <wa-icon slot="prefix" name="circle" style="color: wheat;"></wa-icon>
+              Wheat
+            </wa-option>
+            <wa-option value="lilac">
+              <wa-icon slot="prefix" name="circle" style="color: #C8A2C8;"></wa-icon>
+              Lilac
+            </wa-option>
+            <wa-option value="burnt-orange">
+              <wa-icon slot="prefix" name="circle" style="color: #FF5733"></wa-icon>
+              Burnt Orange
+            </wa-option>
+          </wa-select>
+          <wa-select label="Size" value="large">
+            <wa-option value="small">Small</wa-option>
+            <wa-option value="medium">Medium</wa-option>
+            <wa-option value="large">Large</wa-option>
+            <wa-option value="xl">XL</wa-option>
+            <wa-option value="xxl">XXL</wa-option>
+          </wa-select>
+        </div>
+      </div>
+      <wa-button variant="brand">
+        Add to Cart
+        <wa-icon slot="suffix" name="cart-shopping" variant="solid"></wa-icon>
+      </wa-button>
+    </div>
+  </div>
+</wa-card>
+```
+
+## With Description & Details
+
+```html{.example}
+<wa-card>
+  <div class="wa-split" slot="header">
+    <h3 class="wa-heading-l">Champion® Crossbody Bag</h3>
+    <wa-icon-button name="close" label="Close Preview"></wa-icon-button>
+  </div>
+  <div class="wa-grid wa-gap-xl">
+    <div class="wa-frame wa-border-radius-l" style="aspect-ratio: auto">
+      <img
+        src="https://images.unsplash.com/photo-1643467358005-899641cab7b5?q=80&w=2487&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+        alt="Black weatherproof crossbody bag with two large zipper pockets"
+      />
+    </div>
+    <div class="wa-split:column wa-align-items-stretch wa-gap-xl">
+      <div class="wa-stack wa-gap-xl">
+        <div class="wa-split wa-align-items-start">
+          <span class="wa-heading-2xl">$40</span>
+          <wa-icon-button id="favorite" label="Favorite" name="heart" variant="regular"></wa-icon-button>
+          <wa-tooltip for="favorite">Add to Favorites</wa-tooltip>
+        </div>
+        <div class="wa-split">
+          <div class="wa-cluster wa-gap-xs">
+            <span>3.9</span>
+            <wa-rating value="3.9" readonly></wa-rating>
+          </div>
+          <a href="">See 512 Reviews</a>
+        </div>
+        <wa-divider></wa-divider>
+        <wa-callout size="small">
+          <wa-icon slot="icon" name="circle-info" variant="regular"></wa-icon>
+          You purchased this item on <wa-format-date date="2023-02-20T09:00:00-04:00" month="long" day="numeric" year="numeric"></wa-format-date>
+        </wa-callout>
+        <div class="wa-gap-xs wa-stack">
+          <h4 class="wa-heading-m">About</h4>
+          <p class="wa-body-s">The Champion® Crossbody Bag is crafted for the trendsetter. Its sleek silhouette, paired with a tonal branded adjustable sling strap, ensures you look effortlessly cool no matter where you go.</p>
+        </div> 
+        <wa-divider></wa-divider>
+        <div class="wa-gap-xs wa-stack">
+          <h4 class="wa-heading-m">Details</h4>
+          <dl class="wa-grid" style="--min-column-size: 15ch">
+            <div class="wa-gap-2xs wa-stack">
+              <dt class="wa-body-s">Care Instructions</dt>
+              <dd class="wa-caption-m">Hand Wash Only</dd>
+            </div>
+            <div class="wa-gap-2xs wa-stack">
+              <dt class="wa-body-s">Origin</dt>
+              <dd class="wa-caption-m">Imported</dd>
+            </div>
+            <div class="wa-gap-2xs wa-stack">
+              <dt class="wa-body-s">Country of Origin</dt>
+              <dd class="wa-caption-m">China</dd>
+            </div>
+          </dl>
+        </div>
+      </div>
+      <div class="wa-flank:end wa-align-items-end">
+        <wa-button variant="brand" size="medium">
+          <wa-icon slot="suffix" name="cart-shopping" variant="solid"></wa-icon>Add to Cart 
+        </wa-button>
+        <wa-button appearance="outlined" size="medium">
+          <wa-icon slot="suffix" name="arrow-right" variant="solid"></wa-icon>View Full Details
+        </wa-button>
+      </div>
+    </div>
+  </div>
+</wa-card>
+```

docs/docs/patterns/ecommerce-product-review.md

@@ -1,465 +0,0 @@
----
-title: Product Reviews
-description: TODO
-parent: ecommerce
-tags: e-commerce
----
-
-TODO Page Description
-
-## With images grid
-```html{.example}
-<div class="with-image-grid">
-  <wa-breadcrumb>
-    <wa-breadcrumb-item>Clothing</wa-breadcrumb-item>
-    <wa-breadcrumb-item>Men's</wa-breadcrumb-item>
-    <wa-breadcrumb-item>Shirts &amp; Tops</wa-breadcrumb-item>
-  </wa-breadcrumb>
-  <div class="image-grid">
-    <img src="/assets/images/patterns/gervyn-louis-IS03ajI00Fc-unsplash.jpg" />
-    <img src="/assets/images/patterns/gervyn-louis-KXvd7y7AU6Q-unsplash.jpg" />
-    <img src="/assets/images/patterns/gervyn-louis-semwwyXFQho-unsplash.jpg" />
-    <img src="/assets/images/patterns/mad-rabbit-tattoo-7N4FMowSGek-unsplash.jpg" />
-  </div>
-  <div>
-    <h2>Tank top</h2>
-    <p>The Basic Tee 6-Pack allows you to fully express your vibrant personality with three grayscale options. Feeling adventurous? Put on a heather gray tee. Want to be a trendsetter? Try our exclusive colorway: "Black". Need to add an extra pop of color to your outfit? Our white tee has you covered.</p>
-    <h3>Highlights</h3>
-    <ul>
-      <li>Hand cut and sewn locally</li>
-    </ul>
-
-    <h3>Highlights</h3>
-    <p>The 6-Pack includes two black, two white, and two heather gray Basic Tees. Sign up for our subscription service and be the first to get new, exciting colors, like our upcoming "Charcoal Gray" limited release.</p>
-
-    <span>$192</span>
-    <div>
-      <wa-rating label="Rating" precision="0.5" value="2.5"></wa-rating>
-      <a href="#">117 Reviews</a>
-    </div>
-    <wa-radio-group label="Select an option" hint="Select an option that makes you proud." name="a" value="1">
-  <wa-radio-button value="1">Option 1</wa-radio-button>
-  <wa-radio-button value="2">Option 2</wa-radio-button>
-  <wa-radio-button value="3">Option 3</wa-radio-button>
-</wa-radio-group>
-  <wa-radio-group label="Select an option" hint="Select an option that makes you proud." name="a" value="1">
-  <wa-radio-button value="1">Option 1</wa-radio-button>
-  <wa-radio-button value="2">Option 2</wa-radio-button>
-  <wa-radio-button value="3">Option 3</wa-radio-button>
-</wa-radio-group>
-  <wa-button>Add to Cart</wa-button>
-  </div>
-</div>
-<style>
-  .with-image-grid {
-    wa-breadcrumb::part(base) {
-      margin-bottom: 1rem;
-    }
-
-    .image-grid {
-      display: grid;
-      grid-template-columns: repeat(12, 1fr);
-      gap: 1rem;
-    }
-
-    .image-grid img:nth-of-type(1) {
-      grid-column: 1/-1;
-    }
-
-    .image-grid img:nth-of-type(2) {
-      grid-column: 1/7;
-    }
-    .image-grid img:nth-of-type(3) {
-      grid-column: 7/-1;
-    }
-     .image-grid img:nth-of-type(4) {
-      grid-column: 1/-1;
-    }
-  }
-</style>
-```
-
-## With Tiered Images
-
-```html{.example}
-<div class="with-tiered-images">
-  <wa-breadcrumb>
-    <wa-breadcrumb-item>Clothing</wa-breadcrumb-item>
-    <wa-breadcrumb-item>Men's</wa-breadcrumb-item>
-    <wa-breadcrumb-item>Shirts &amp; Tops</wa-breadcrumb-item>
-  </wa-breadcrumb>
-  <div>
-    <div class="heading">
-      <h2>Basic Tee</h2>
-      <span style="font-size: var(--wa-font-size-2xl)">$35</span>
-    </div>
-    <div class="rating">
-      <span>3.9</span>
-       <wa-rating label="Rating" precision="0.5" value="3.9"></wa-rating>
-      <a href="#">117 Reviews</a>
-    </div>
-    <div class="tiered-images">
-      <img src="/assets/images/patterns/gervyn-louis-IS03ajI00Fc-unsplash.jpg" />
-      <img src="/assets/images/patterns/gervyn-louis-KXvd7y7AU6Q-unsplash.jpg" />
-      <img src="/assets/images/patterns/gervyn-louis-semwwyXFQho-unsplash.jpg" />
-    </div>
-  </div>
-  <wa-radio-group label="Select an option" hint="Select an option that makes you proud." name="a" value="1">
-  <wa-radio-button value="1">Option 1</wa-radio-button>
-  <wa-radio-button value="2">Option 2</wa-radio-button>
-  <wa-radio-button value="3">Option 3</wa-radio-button>
-</wa-radio-group>
-  <wa-radio-group label="Select an option" hint="Select an option that makes you proud." name="a" value="1">
-  <wa-radio-button value="1">Option 1</wa-radio-button>
-  <wa-radio-button value="2">Option 2</wa-radio-button>
-  <wa-radio-button value="3">Option 3</wa-radio-button>
-</wa-radio-group>
- <wa-button>Add to Cart</wa-button>
- <h3>Description</h3>
- <p>The Basic tee is an honest new take on a classic. The tee uses super soft, pre-shrunk cotton for true comfort and a dependable fit. They are hand cut and sewn locally, with a special dye technique that gives each tee it's own look.</p>
- <p>Looking to stock your closet? The Basic tee also comes in a 3-pack or 5-pack at a bundle discount.</p>
- <hr />
- <h3>Highlights</h3>
-    <ul>
-      <li>Hand cut and sewn locally</li>
-    </ul>
-  <div>
-    <wa-card>
-      <wa-icon family="solid" name="earth-americas"></wa-icon>
-      <h3>International delivery</h3>
-      <p>Get your order in 2 years</p>
-    </wa-card>
-    <wa-card>
-      <wa-icon family="solid" name="earth-americas"></wa-icon>
-      <h3>International delivery</h3>
-      <p>Get your order in 2 years</p>
-
-    </wa-card>
-  </div>
-</div>
-<style>
-  .with-tiered-images {
-    wa-breadcrumb::part(base) {
-      margin-bottom: 1rem;
-    }
-    .heading {
-      display: flex;
-      justify-content: space-between;
-      align-items: center;
-    }
-
-    .rating {
-      display: flex;
-
-      span {
-        display: inline-block;
-        margin-right: 1rem;
-      }
-
-      wa-rating {
-        margin-right: 1rem;
-      }
-    }
-
-    .tiered-images {
-      display: grid;
-      grid-template-columns: repeat(12, 1fr);
-      gap: 1rem;
-    }
-
-    .tiered-images img:nth-of-type(1) {
-      grid-column: 1/-1;
-    }
-
-    .tiered-images img:nth-of-type(2) {
-      grid-column: 1/7;
-    }
-    .tiered-images img:nth-of-type(3) {
-      grid-column: 7/-1;
-  }
-</style>
-```
-## with images and expandable details
-
-```html {.example}
-<wa-carousel class="carousel-thumbnails" navigation loop>
-  <wa-carousel-item>
-    <img
-      alt="The sun shines on the mountains and trees (by Adam Kool on Unsplash)"
-      src="/assets/examples/carousel/pullover-1.jpg"
-    />
-  </wa-carousel-item>
-  <wa-carousel-item>
-    <img
-      alt="A waterfall in the middle of a forest (by Thomas Kelly on Unsplash)"
-      src="/assets/examples/carousel/pullover-2.jpg"
-    />
-  </wa-carousel-item>
-  <wa-carousel-item>
-    <img
-      alt="The sun is setting over a lavender field (by Leonard Cotte on Unsplash)"
-      src="/assets/examples/carousel/pullover-3.jpg"
-    />
-  </wa-carousel-item>
-  <wa-carousel-item>
-    <img
-      alt="A field of grass with the sun setting in the background (by Sapan Patel on Unsplash)"
-      src="/assets/examples/carousel/pullover-4.jpg"
-    />
-  </wa-carousel-item>
-  <wa-carousel-item>
-    <img
-      alt="A scenic view of a mountain with clouds rolling in (by V2osk on Unsplash)"
-      src="/assets/examples/carousel/pullover-5.jpg"
-    />
-  </wa-carousel-item>
-</wa-carousel>
-
-<div class="thumbnails">
-  <div class="thumbnails__scroller">
-    <img alt="Thumbnail by 1" class="thumbnails__image active" src="/assets/examples/carousel/pullover-1.jpg" />
-    <img alt="Thumbnail by 2" class="thumbnails__image" src="/assets/examples/carousel/pullover-2.jpg" />
-    <img alt="Thumbnail by 3" class="thumbnails__image" src="/assets/examples/carousel/pullover-3.jpg" />
-    <img alt="Thumbnail by 4" class="thumbnails__image" src="/assets/examples/carousel/pullover-4.jpg" />
-    <img alt="Thumbnail by 5" class="thumbnails__image" src="/assets/examples/carousel/pullover-5.jpg" />
-  </div>
-</div>
-<div>
-  <h3 style="--wa-space-xl: 0;">Pullover Sweater</h3>
-  <span class="price-big">$140</span>
-  <wa-rating class="sweater-rating" label="Rating" precision="0.5" value="2.5"></wa-rating>
-  <p>The Zip Tote Basket is the perfect midpoint between shopping tote and comfy backpack. With convertible straps, you can hand carry, should sling, or backpack this convenient and spacious bag. The zip top and durable canvas construction keeps your goods protected for all-day use.</p>
-  <wa-radio-group label="Select Color" hint="Select an option that makes you proud." name="a" value="1">
-  <wa-radio-button value="1"></wa-radio-button>
-  <wa-radio-button value="2"></wa-radio-button>
-  <wa-radio-button value="3"></wa-radio-button>
-</wa-radio-group>
-<div>
-  <wa-button>Add to cart</wa-button>
-  <wa-icon-button name="gear" label="Settings"></wa-icon-button>
-</div>
-<div class="details-group-example">
-  <wa-details summary="First" open>
-    Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna
-    aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
-  </wa-details>
-
-  <wa-details summary="Second">
-    Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna
-    aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
-  </wa-details>
-
-  <wa-details summary="Third">
-    Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna
-    aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.
-  </wa-details>
-</div>
-</div>
-
-<style>
-  .carousel-thumbnails {
-    --slide-aspect-ratio: 3 / 2;
-  }
-
-  wa-radio-button #shadow-root div .button--medium {
-    padding: var(--wa-space-xs) var(--wa-space-xs);
-  }
-
-  .color-circle {
-    --background: #000;
-    background: var(--background);
-
-    width: 50px;
-    height: 100%;
-  }
-
-  .sweater-rating {
-    margin-bottom: 1rem;
-  }
-  .price-big {
-    display: block;
-    font-size: 32px;
-  }
-
-  .thumbnails {
-    display: flex;
-    justify-content: center;
-    margin-bottom: 1rem;
-  }
-
-  .thumbnails__scroller {
-    display: flex;
-    gap: var(--wa-space-s);
-    overflow-x: auto;
-    scrollbar-width: none;
-    scroll-behavior: smooth;
-    scroll-padding: var(--wa-space-s);
-  }
-
-  .thumbnails__scroller::-webkit-scrollbar {
-    display: none;
-  }
-
-  .thumbnails__image {
-    width: 64px;
-    height: 64px;
-    object-fit: cover;
-
-    opacity: 0.3;
-    will-change: opacity;
-    transition: 250ms opacity;
-
-    cursor: pointer;
-  }
-
-  .thumbnails__image.active {
-    opacity: 1;
-  }
-  .details-group-example wa-details:not(:last-of-type) {
-    margin-bottom: var(--wa-space-2xs);
-  }
-</style>
-
-<script>
-  {
-    const carousel = document.querySelector('.carousel-thumbnails');
-    const scroller = document.querySelector('.thumbnails__scroller');
-    const thumbnails = document.querySelectorAll('.thumbnails__image');
-
-    scroller.addEventListener('click', e => {
-      const target = e.target;
-
-      if (target.matches('.thumbnails__image')) {
-        const index = [...thumbnails].indexOf(target);
-        carousel.goToSlide(index);
-      }
-    });
-
-    carousel.addEventListener('wa-slide-change', e => {
-      const slideIndex = e.detail.index;
-
-      [...thumbnails].forEach((thumb, i) => {
-        thumb.classList.toggle('active', i === slideIndex);
-        if (i === slideIndex) {
-          thumb.scrollIntoView({
-            block: 'nearest'
-          });
-        }
-      });
-    });
-  }
-
-    const container = document.querySelector('.details-group-example');
-
-  // Close all other details when one is shown
-  container.addEventListener('wa-show', event => {
-    if (event.target.localName === 'wa-details') {
-      [...container.querySelectorAll('wa-details')].map(details => (details.open = event.target === details));
-    }
-  });
-</script>
-```
-
-## Split with image
-
-```html {.example}
-<div class="split-with-image">
-  <div class="div-1">
-    <wa-breadcrumb>
-    <wa-breadcrumb-item>Clothing</wa-breadcrumb-item>
-    <wa-breadcrumb-item>Men's</wa-breadcrumb-item>
-    <wa-breadcrumb-item>Shirts &amp; Tops</wa-breadcrumb-item>
-    </wa-breadcrumb>
-    <h2>Everyday Ruck Snack</h2>
-    <span>
-      <span>$220</span> |
-      <wa-rating label="Rating" precision="0.5" value="2.5"></wa-rating>
-      <span>1624 reviews</span>
-    </span>
-    <p>Don't compromise on snack-carrying capacity with this lightweight and spacious bag. The drawstring top keeps all your favorite chips, crisps, fries, biscuits, crackers, and cookies secure.</p>
-    <span><wa-icon family="solid" name="check"></wa-icon> In stock and ready to ship</span>
-
-
-  </div>
-  <div class="div-2">
-    <img src="/assets/images/patterns/gervyn-louis-IS03ajI00Fc-unsplash.jpg" />
-  </div>
-  <div class="div-3">
-     <wa-radio-group label="Select an option" hint="Select an option that makes you proud." name="a" value="1">
-  <wa-radio-button value="1">Option 1</wa-radio-button>
-  <wa-radio-button value="2">Option 2</wa-radio-button>
-  <wa-radio-button value="3">Option 3</wa-radio-button>
-</wa-radio-group>
-  </div>
-</div>
-<style>
-  .split-with-image {
-    display: grid;
-    /* grid-template-columns: repeat(2, 1fr); */
-    /* height: 1000px; */
-    /* gap: 1rem; */
-    .div-1 {
-
-    }
-    .div-2 {
-      /* background-color: black;
-      grid-column-start: 2;
-      grid-row: span 2 / span 2; */
-    }
-    .div-3 {
-
-    }
-  }
-</style>
-```
-## With tabs
-
-```html{.example}
-<div>
-  <wa-rating class="sweater-rating" label="Rating" precision="0.5" value="2.5"></wa-rating>
-  <h2>Application UI Icon Pack</h2>
-  <img alt="Sample of 30 icons with friendly and fun details in outline, filled, and brand color styles." src="https://tailwindui.com/img/ecommerce-images/product-page-05-product-01.jpg" class="aqk aql">
-  <p>The Application UI Icon Pack comes with over 200 icons in 3 styles: outline, filled, and branded. This playful icon pack is tailored for complex application user interfaces with a friendly and legible look.</p>
-  <wa-button variant="brand">Brand</wa-button>
-
-<wa-button variant="success">Success</wa-button>
-<hr />
-<h3>Highlights</h3>
-<ul>
-  <li>200+ SVG icons in 3 unique styles</li>
-  <li>Compatible with Figma, Sketch, and Adobe XD</li>
-  <li>Drawn on 24 x 24 pixel grid</li>
-</ul>
-<hr />
-<h3>License</h3>
-<p>For personal and professional use. You cannot resell or redistribute these icons in their original or modified state. <a href="#">Read full license</a></p>
-<hr />
-<h3>Share</h3>
-
-
-<wa-icon family="brands" name="facebook"></wa-icon>
-<wa-icon family="brands" name="instagram"></wa-icon>
-<wa-icon family="brands" name="x-twitter"></wa-icon>
-  <wa-tab-group>
-  <wa-tab panel="general">General</wa-tab>
-  <wa-tab panel="custom">Custom</wa-tab>
-  <wa-tab panel="advanced">Advanced</wa-tab>
-  <wa-tab panel="disabled" disabled>Disabled</wa-tab>
-
-  <wa-tab-panel name="general">
-    <div></div>
-    <div>
-      <h3>Hector Gibbons</h3>
-      <p>July 12, 2021</p>
-      <wa-rating label="Rating" precision="0.5" value="2.5"></wa-rating>
-      <p>Blown away by how polished this icon pack is. Everything looks so consistent and each SVG is optimized out of the box so I can use it directly with confidence. It would take me several hours to create a single icon this good, so it's a steal at this price.</p>
-    </div>
-  </wa-tab-panel>
-  <wa-tab-panel name="custom">This is the custom tab panel.</wa-tab-panel>
-  <wa-tab-panel name="advanced">This is the advanced tab panel.</wa-tab-panel>
-  <wa-tab-panel name="disabled">This is a disabled tab panel.</wa-tab-panel>
-</wa-tab-group>
-
-</div>
-
-```

docs/docs/patterns/ecommerce-review.md

@@ -0,0 +1,213 @@
+---
+title: Product Reviews
+description: 'Help shoppers make informed decisions with ratings, reviews, and testimonials from your customers.'
+parent: ecommerce
+tags: e-commerce
+---
+## Multi column
+
+```html{.example}
+<div style="max-width: 960px; margin: 0 auto;">
+  <span class="wa-heading-m">Recent Reviews</span>
+  <wa-divider></wa-divider>
+  <div class="wa-flank wa-gap-s" style="--flank-size: 20%">
+    <div class="wa-stack wa-gap-2xs">
+      <span class="wa-heading-s">Viktor Vaughn</span>
+      <span class="wa-caption-m"><em>September 23rd, 2023</em></span>
+    </div>
+    <div class="wa-flank">
+      <wa-rating label="Rating" readonly value="5"></wa-rating>
+    <div class="wa-stack wa-gap-2xs">
+      <span class="wa-heading-s">Rating Title</span>
+      <p class="wa-caption-m">Best treadmill I've ever owned! It has a sleek design, and the features are top-notch. I use it daily for my cardio workouts, and the motor is powerful enough to keep up with my running. It’s easy to adjust the speed and incline, and the display is clear and simple to read. Worth every penny!</p>
+    </div>
+    </div>
+  </div>
+  <wa-divider></wa-divider>
+  <div class="wa-flank wa-gap-s" style="--flank-size: 20%">
+    <div class="wa-stack wa-gap-2xs">
+      <span class="wa-heading-s">Ben Grimm</span>
+      <span class="wa-caption-m"><em>May 5th, 2023</em></span>
+    </div>
+    <div class="wa-flank">
+      <wa-rating label="Rating" readonly value="4"></wa-rating>
+    <div class="wa-stack wa-gap-2xs">
+      <span class="wa-heading-s">Rating Title</span>
+      <p class="wa-caption-m">Decent treadmill for the price, but I feel like the belt could be a little wider for comfort. The cushioning is good, but sometimes I experience a slight wobble when running at high speeds. For casual walking, it's fine, but I’m not sure it’s built for intense runners.</p>
+    </div>
+    </div>
+  </div>
+  <wa-divider></wa-divider>
+  <div class="wa-flank wa-gap-s" style="--flank-size: 20%">
+    <div class="wa-stack wa-gap-2xs">
+      <span class="wa-heading-s">Johnny Storm</span>
+      <span class="wa-caption-m"><em>March 3rd, 2023</em></span>
+    </div>
+    <div class="wa-flank">
+      <wa-rating label="Rating" readonly value="4"></wa-rating>
+    <div class="wa-stack wa-gap-2xs">
+      <span class="wa-heading-s">Rating Title</span>
+      <p class="wa-caption-m">This treadmill has been a great addition to my home gym. It's sturdy, easy to use, and I like that it tracks my steps and heart rate. The only downside is that it's a bit bulky, so I had to rearrange my space to make room for it. Overall, I'm happy with the performance and would recommend it.</p>
+    </div>
+    </div>
+  </div>
+  <wa-divider></wa-divider>
+  <div class="wa-flank wa-gap-s" style="--flank-size: 20%">
+    <div class="wa-stack wa-gap-2xs">
+      <span class="wa-heading-s">Sue Storm</span>
+      <span class="wa-caption-m"><em>February 26th, 2023</em></span>
+    </div>
+    <div class="wa-flank">
+      <wa-rating label="Rating" readonly value="4"></wa-rating>
+    <div class="wa-stack wa-gap-2xs">
+      <span class="wa-heading-s">Rating Title</span>
+      <p class="wa-caption-m">I absolutely love my new treadmill! It’s perfect for my daily workouts. The setup was quick, and it’s so quiet that I can use it while watching TV without any interruptions. The different incline levels really help mix up my routine, and the built-in programs keep things interesting. Highly recommend for anyone looking to stay fit at home!</p>
+    </div>
+    </div>
+  </div>
+</div>
+```
+## With Ratings Distribution
+
+```html {.example}
+<div style="max-width: 960px; margin: 0 auto;">
+  <div class="wa-align-items-start wa-flank wa-gap-2xl">
+    <div class="wa-gap-s wa-stack">
+      <span class="wa-heading-m">Customer Reviews</span>
+      <div class="wa-stack wa-gap-xs"><wa-rating label="Rating" precision="0.5" value="4.6" size="small"></wa-rating> <span class="wa-caption-m">Based on 1624 reviews</span></div>
+      <div class="wa-stack">
+        <span class="wa-cluster wa-gap-2xs">
+          <span>5</span>
+          <wa-icon name="star" style="font-size: 12px;"></wa-icon>
+          <wa-progress-bar value="63" label="Upload progress" style="height: 6px; width: 50%"></wa-progress-bar>
+          <span>63%</span>
+        </span>
+        <span class="wa-cluster wa-gap-2xs">
+          <span>4</span>
+          <wa-icon name="star" style="font-size: 12px;"></wa-icon>
+          <wa-progress-bar value="17" label="Upload progress" style="height: 6px; width: 50%"></wa-progress-bar>
+          <span>17%</span>
+        </span>
+        <span class="wa-cluster wa-gap-2xs">
+          <span>3</span>
+          <wa-icon name="star" style="font-size: 12px;"></wa-icon>
+          <wa-progress-bar value="15" label="Upload progress" style="height: 6px; width: 50%"></wa-progress-bar>
+          <span>15%</span>
+        </span>
+        <span class="wa-cluster wa-gap-2xs">
+          <span>2</span>
+          <wa-icon name="star" style="font-size: 12px;"></wa-icon>
+          <wa-progress-bar value="3" label="Upload progress" style="height: 6px; width: 50%"></wa-progress-bar>
+          <span>3%</span>
+        </span>
+        <span class="wa-cluster wa-gap-2xs">
+          <span>1</span>
+          <wa-icon name="star" style="font-size: 12px;"></wa-icon>
+          <wa-progress-bar value="2" label="Upload progress" style="height: 6px; width: 50%"></wa-progress-bar>
+          <span>2%</span>
+        </span>
+      </div>
+    </div>
+    <div>
+      <div>
+        <div class="wa-flank">
+          <wa-avatar image="https://images.unsplash.com/photo-1494790108377-be9c29b29330?q=80&w=2574&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"></wa-avatar>
+          <div class="wa-stack wa-gap-2xs">
+            <span class="wa-heading-s">Emily Selman</span>
+            <wa-rating label="Rating" precision="0.5" value="2.5"></wa-rating>
+          </div>
+        </div>
+        <p class="wa-caption-l"><em>This is the bag of my dreams. I took it on my last vacation and was able to fit an absurd amount of snacks for the many long and hungry flights.</em></p>
+      </div>
+      <wa-divider></wa-divider>
+      <div>
+        <div class="wa-flank">
+          <wa-avatar image="https://images.unsplash.com/photo-1599566150163-29194dcaad36?q=80&w=2574&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"></wa-avatar>
+          <div class="wa-stack wa-gap-2xs">
+            <span class="wa-heading-s">Emily Selman</span>
+            <wa-rating label="Rating" precision="0.5" value="2.5"></wa-rating>
+          </div>
+        </div>
+        <p class="wa-caption-l"><em>This is the bag of my dreams. I took it on my last vacation and was able to fit an absurd amount of snacks for the many long and hungry flights.</em></p>
+      </div>
+      <wa-divider></wa-divider>
+      <div>
+        <div class="wa-flank">
+          <wa-avatar image="https://images.unsplash.com/photo-1580489944761-15a19d654956?q=80&w=2561&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"></wa-avatar>
+          <div class="wa-stack wa-gap-2xs">
+            <span class="wa-heading-s">Emily Selman</span>
+            <wa-rating label="Rating" precision="0.5" value="2.5"></wa-rating>
+          </div>
+        </div>
+        <p class="wa-caption-l"><em>This is the bag of my dreams. I took it on my last vacation and was able to fit an absurd amount of snacks for the many long and hungry flights.</em></p>
+      </div>
+      <wa-divider></wa-divider>
+      <div>
+        <div class="wa-flank">
+          <wa-avatar image="https://images.unsplash.com/photo-1566492031773-4f4e44671857?q=80&w=2574&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"></wa-avatar>
+          <div class="wa-stack wa-gap-2xs">
+            <span class="wa-heading-s">Emily Selman</span>
+            <wa-rating label="Rating" precision="0.5" value="2.5"></wa-rating>
+          </div>
+        </div>
+        <p class="wa-caption-l"><em>This is the bag of my dreams. I took it on my last vacation and was able to fit an absurd amount of snacks for the many long and hungry flights.</em></p>
+      </div>
+    </div>
+  </div>
+</div>
+```
+
+## Two Column
+
+```html{.example}
+<div class="wa-stack" style="max-width: 960px; margin: 0 auto;">
+  <div class="wa-flank wa-align-items-center">
+    <div class="wa-stack wa-align-items-center wa-gap-xs">
+      <wa-avatar label="User avatar" image="https://images.unsplash.com/photo-1607746882042-944635dfe10e?q=80&w=2670&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"></wa-avatar>
+      <p>Ripley</p>
+      <div>
+      <wa-icon-button name="thumbs-up" label="I don't like this review" style="color: var(--wa-color-success-fill-loud);"></wa-icon-button>
+      <wa-icon-button name="thumbs-down" label="I like this review" style="color: var(--wa-color-danger-fill-loud);"></wa-icon-button>
+    </div>
+    </div>
+    <div>
+      <wa-rating label="Rating" precision="0.5" value="5" readonly></wa-rating>
+      <p>I recently purchased the Modern Sofa Couch, and I couldn't be happier with my decision! The process from ordering to delivery was smooth and hassle-free</p>
+    </div>
+   
+  </div>
+  <wa-divider></wa-divider>
+  <div class="wa-flank wa-align-items-center">
+    <div class="wa-stack wa-align-items-center wa-gap-xs">
+      <wa-avatar label="User avatar" image="https://images.unsplash.com/photo-1507003211169-0a1dd7228f2d?q=80&w=2574&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"></wa-avatar>
+      <p>Kane</p>
+      <div>
+      <wa-icon-button name="thumbs-up" label="I don't like this review" style="color: var(--wa-color-success-fill-loud);"></wa-icon-button>
+      <wa-icon-button name="thumbs-down" label="I like this review" style="color: var(--wa-color-danger-fill-loud);"></wa-icon-button>
+    </div>
+    </div>
+    <div>
+      <wa-rating label="Rating" precision="0.5" value="3.4" readonly></wa-rating>
+      <p>The cushions are soft yet supportive, and the sectional layout gives plenty of space to stretch out. It’s perfect for movie nights or just lounging with a good book.</p>
+    </div>
+    
+  </div>
+  <wa-divider></wa-divider>
+  <div class="wa-flank wa-align-items-center">
+    <div class="wa-stack wa-align-items-center wa-gap-xs">
+      <wa-avatar label="User avatar" image="https://images.unsplash.com/photo-1728577740843-5f29c7586afe?q=80&w=2680&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"></wa-avatar>
+      <p>Parker</p>
+      <div>
+      <wa-icon-button name="thumbs-up" label="I don't like this review" style="color: var(--wa-color-success-fill-loud);"></wa-icon-button>
+      <wa-icon-button name="thumbs-down" label="I like this review" style="color: var(--wa-color-danger-fill-loud);"></wa-icon-button>
+    </div>
+    </div>
+    <div>
+      <wa-rating label="Rating" precision="0.5" value="3.8" readonly></wa-rating>
+      <p>The leather is high quality, but it’s a little firmer than I thought. That said, after sitting on it for a while, it does soften up and feels more comfortable. It’s perfect if you’re looking for a more structured seating experience.</p>
+    </div>
+    
+  </div>
+  <wa-divider></wa-divider>
+</div>
+```

docs/docs/patterns/ecommerce-shopping-cart.md

@@ -1,10 +1,279 @@
 ---
 title: Shopping Cart
-description: TODO
+description: 'Give shoppers an overview of selected items with shopping carts that let them edit items and proceed to checkout.'
 parent: ecommerce
 tags: e-commerce
 ---
 
-TODO Page Description
+## Two Columns with Summary Card
 
-## Examples
+```html {.example}
+<div class="wa-stack wa-gap-2xl">
+  <h2>Shopping Cart</h2>
+  <div class="wa-grid wa-align-items-start wa-gap-2xl">
+    <div class="wa-stack wa-gap-xl">
+      <article class="wa-flank wa-gap-xl" style="--flank-size: 8rem">
+        <div class="wa-frame wa-border-radius-m">
+          <img 
+            src="https://images.unsplash.com/photo-1523381294911-8d3cead13475?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w1OTAyOTl8MHwxfGFsbHx8fHx8fHx8fDE3MTg2NDIzNDd8&ixlib=rb-4.0.3&q=80&w=1080"
+            alt=""
+          />
+        </div>
+        <div class="wa-flank:end wa-align-items-baseline">
+          <div class="wa-stack wa-gap-xs">
+            <h3 class="wa-heading-s">Classic Tee</h3>
+            <span class="wa-caption-m">Sage Green</span>
+            <span class="wa-caption-m">Large</span>
+            <span>$20.00</span>
+          </div>
+          <wa-icon-button name="xmark" label="Remove" id="remove-1"></wa-icon-button>
+          <wa-tooltip for="remove-1">Remove</wa-tooltip>
+        </div>
+      </article>
+      <article class="wa-flank wa-gap-xl" style="--flank-size: 8rem">
+        <div class="wa-frame wa-border-radius-m">
+          <img 
+            src="https://images.unsplash.com/photo-1564859227552-81fde4a1df0b?q=80&w=2671&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+            alt=""
+          />
+        </div>
+        <div class="wa-flank:end wa-align-items-baseline">
+          <div class="wa-stack wa-gap-xs">
+            <h3 class="wa-heading-s">RVCA Graphic</h3>
+            <span class="wa-caption-m">White</span>
+            <span class="wa-caption-m">Large</span>
+            <span>$25.00</span>
+          </div>
+          <wa-icon-button name="xmark" label="Remove" id="remove-2"></wa-icon-button>
+          <wa-tooltip for="remove-2">Remove</wa-tooltip>
+        </div>
+      </article>
+      <article class="wa-flank wa-gap-xl" style="--flank-size: 8rem">
+        <div class="wa-frame wa-border-radius-m">
+          <img 
+            src="https://images.unsplash.com/photo-1503341733017-1901578f9f1e?q=80&w=2670&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+            alt=""
+          />
+        </div>
+        <div class="wa-flank:end wa-align-items-baseline">
+          <div class="wa-stack wa-gap-xs">
+            <h3 class="wa-heading-s">Stay Wild Graphic</h3>
+            <span class="wa-caption-m">Black</span>
+            <span class="wa-caption-m">Large</span>
+            <span>$18.00</span>
+          </div>
+          <wa-icon-button name="xmark" label="Remove" id="remove-3"></wa-icon-button>
+          <wa-tooltip for="remove-3">Remove</wa-tooltip>
+        </div>
+      </article>
+    </div>
+    <wa-card>
+      <div slot="header">
+        <h3 class="wa-heading-m">Order Summary</h3>
+      </div>
+      <div class="wa-stack">
+        <div class="wa-split">
+          <span class="wa-caption-l">Subtotal</span>
+          <strong>$63.00</strong>
+        </div>
+        <wa-divider></wa-divider>
+        <div class="wa-split">
+          <span class="wa-caption-l">Shipping</span>
+          <strong>$5.00</strong>
+        </div>
+        <wa-divider></wa-divider>
+        <div class="wa-split">
+          <span class="wa-caption-l">Tax</span>
+          <strong>$5.50</strong>
+        </div>
+        <wa-divider></wa-divider>
+        <div class="wa-split wa-body-l">
+          <span>Total</span>
+          <strong>$73.50</strong>
+        </div>
+        <wa-button variant="brand">Checkout</wa-button>
+      </div>
+    </wa-card>
+  </div>
+</div>
+</div>
+```
+
+## Single Column
+
+```html {.example}
+<div class="wa-stack wa-gap-2xl" style="max-width: 60ch; margin: auto">
+  <h2>Your Cart</h2>
+  <wa-divider></wa-divider>
+  <article class="wa-flank" style="--flank-size: 12rem">
+    <div class="wa-frame wa-border-radius-m" style="aspect-ratio: 3 / 2">
+      <img
+        src="https://images.unsplash.com/photo-1594787317357-dcda50fd1d78?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w1OTAyOTl8MHwxfGFsbHx8fHx8fHx8fDE3MTg2NDI4MDd8&ixlib=rb-4.0.3&q=80&w=1080"
+        alt=""
+      />
+    </div>
+    <div class="wa-split:column wa-align-items-stretch wa-gap-xs">
+      <div class="wa-stack wa-gap-xs">
+        <span class="wa-split wa-gap-xs">
+          <h3 class="wa-heading-m">Convertible</h3>
+          <span>$32.00</span>
+        </span>
+        <wa-tag size="small" variant="neutral" appearance="filled" pill style="width: fit-content">Cherry Red</wa-tag>
+      </div>
+      <div class="wa-split">
+        <wa-badge appearance="filled" variant="success">In Stock</wa-badge>
+        <wa-button appearance="plain" size="small" variant="danger">
+          <wa-icon slot="suffix" name="trash"></wa-icon>
+          Remove
+        </wa-button>
+      </div>
+    </div>
+  </article>
+  <wa-divider></wa-divider>
+  <article class="wa-flank" style="--flank-size: 12rem">
+    <div class="wa-frame wa-border-radius-m" style="aspect-ratio: 3 / 2">
+      <img
+        src="https://images.unsplash.com/photo-1597670250484-0e9aff7f8804?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w1OTAyOTl8MHwxfGFsbHx8fHx8fHx8fDE3MTg2NDI4NTB8&ixlib=rb-4.0.3&q=80&w=1080"
+        alt=""
+      />
+    </div>
+    <div class="wa-split:column wa-align-items-stretch wa-gap-xs">
+      <div class="wa-stack wa-gap-xs">
+        <span class="wa-split wa-gap-xs">
+          <h3 class="wa-heading-m">Racers (3 Pack)</h3>
+          <span>$80.00</span>
+        </span>
+        <wa-tag size="small" variant="neutral" appearance="filled" pill style="width: fit-content">Assorted Colors</wa-tag>
+      </div>
+      <div class="wa-split">
+        <wa-badge appearance="filled" variant="success">In Stock</wa-badge>
+        <wa-button appearance="plain" size="small" variant="danger">
+          <wa-icon slot="suffix" name="trash"></wa-icon>
+          Remove
+        </wa-button>
+      </div>
+    </div>
+  </article>
+  <wa-divider></wa-divider>
+  <article class="wa-flank" style="--flank-size: 12rem">
+    <div class="wa-frame wa-border-radius-m" style="aspect-ratio: 3 / 2">
+      <img
+        src="https://images.unsplash.com/photo-1594787826350-19386fdb2363?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w1OTAyOTl8MHwxfGFsbHx8fHx8fHx8fDE3MTg2NDI4ODV8&ixlib=rb-4.0.3&q=80&w=1080"
+        alt=""
+      />
+    </div>
+    <div class="wa-split:column wa-align-items-stretch wa-gap-xs">
+      <div class="wa-stack wa-gap-xs">
+        <span class="wa-split wa-gap-xs">
+          <h3 class="wa-heading-m">Volkswagen T2</h3>
+          <span>$60.00</span>
+        </span>
+        <wa-tag size="small" variant="neutral" appearance="filled" pill style="width: fit-content">Red/White</wa-tag>
+      </div>
+      <div class="wa-split">
+        <wa-badge appearance="filled" variant="warning">Low Stock</wa-badge>
+        <wa-button appearance="plain" size="small" variant="danger">
+          <wa-icon slot="suffix" name="trash"></wa-icon>
+          Remove
+        </wa-button>
+      </div>
+    </div>
+  </article>
+  <wa-divider></wa-divider>
+  <div class="wa-stack">
+    <div class="wa-split">
+      <h3 class="wa-heading-m">Subtotal</h3>
+      <span class="wa-body-l">$172.00</span>
+    </div>
+    <span class="wa-caption-m">Shipping and taxes calculated at checkout</span>
+    <wa-button size="large" variant="brand">Checkout</wa-button>
+    <div class="cluster">
+      <span class="wa-caption-m">Not quite ready?</span>
+      <wa-button appearance="plain" size="small" variant="brand">
+        Continue Shopping
+        <wa-icon name="arrow-right"></wa-icon>
+      </wa-button>
+    </div>
+  </div>
+</div>
+```
+
+## Drawer
+
+```html {.example viewport}
+<wa-drawer label="Shopping Cart" with-header with-footer open>
+  <div class="wa-stack">
+    <article class="wa-flank" style="--flank-size: 6rem">
+      <div class="wa-frame wa-border-radius-m">
+        <img 
+          src="https://images.unsplash.com/photo-1704677982224-89cd6d039fa6?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w1OTAyOTl8MHwxfGFsbHx8fHx8fHx8fDE3MTg2NDEwOTJ8&ixlib=rb-4.0.3&q=80&w=1080"
+          alt=""
+        />
+      </div>
+      <div class="wa-stack wa-gap-2xs"> 
+        <div class="wa-split wa-gap-2xs">
+          <strong>AJ1 Low</strong>
+          <strong>$170.00</strong>
+        </div>
+        <span class="wa-caption-m">Multi-color</span>
+        <div class="wa-split wa-gap-2xs">
+          <span class="wa-body-s">Qty: 1</span>
+          <wa-button appearance="plain" size="small">Remove</wa-button>
+        </div>
+      </div>
+    </article>
+    <wa-divider></wa-divider>
+    <article class="wa-flank" style="--flank-size: 6rem">
+      <div class="wa-frame wa-border-radius-m">
+        <img
+          src="https://images.unsplash.com/photo-1672908615254-71a0b373eaba?q=80&w=3560&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+          alt="(Photograph by Hamed darzi)"
+        />
+      </div>
+      <div class="wa-stack wa-gap-2xs"> 
+        <div class="wa-split wa-gap-2xs">
+          <strong>The Trails</strong>
+          <strong>$35.00</strong>
+        </div>
+        <span class="wa-caption-m">Twilight Blue</span>
+        <div class="wa-split wa-gap-2xs">
+          <span class="wa-body-s">Qty: 1</span>
+          <wa-button appearance="plain" size="small">Remove</wa-button>
+        </div>
+      </div>
+    </article>
+    <wa-divider></wa-divider>
+    <article class="wa-flank" style="--flank-size: 6rem">
+      <div class="wa-frame wa-border-radius-m">
+        <img 
+          src="https://images.unsplash.com/photo-1693443687750-611ad77f3aba?q=80&w=3540&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D"
+          alt="(Photograph by tian dayong)"
+        />
+      </div>
+      <div class="wa-stack wa-gap-2xs"> 
+        <div class="wa-split wa-gap-2xs">
+          <strong>Outcast 2-pack</strong>
+          <strong>$27.00</strong>
+        </div>
+        <span class="wa-caption-m">Black / White</span>
+        <div class="wa-split wa-gap-2xs">
+          <span class="wa-body-s">Qty: 1</span>
+          <wa-button appearance="plain" size="small">Remove</wa-button>
+        </div>
+      </div>
+    </article>
+  </div>
+  <div slot="footer" class="wa-stack" style="width: 100%">
+    <div class="wa-split">
+      <strong>Subtotal</strong>
+      <strong>$232.00</strong>
+    </div>
+    <span class="wa-caption-m">Shipping and taxes calculated at checkout.</span>
+    <wa-button variant="brand">Checkout</wa-button>
+    <wa-button appearance="plain" size="small" variant="brand">
+      Continue Shopping
+      <wa-icon name="arrow-right"></wa-icon>
+    </wa-button>
+  </div>
+</wa-drawer>
+```

docs/docs/patterns/ecommerce-store-navigation.md

@@ -0,0 +1,85 @@
+---
+title: Store Navigation
+description: 'Help shoppers explore categories and find products with all of the links they need to navigate your store.'
+parent: ecommerce
+unlisted: true
+---
+
+## Popup Menu
+
+```html{.example}
+<wa-dropdown>
+  <wa-button slot="trigger" caret>Shop</wa-button>
+  <wa-menu class="mm-grid">
+    <div>
+      <wa-menu-label>Shop by Department</wa-menu-label>
+      <wa-menu-item value="apple">Mens</wa-menu-item>
+      <wa-menu-item value="banana">Womens</wa-menu-item>
+      <wa-menu-item value="orange">Kids</wa-menu-item>
+      <wa-menu-item value="orange">
+        Infants
+         <wa-menu slot="submenu">
+      <wa-menu-item value="uppercase">Newborns</wa-menu-item>
+      <wa-menu-item value="lowercase">6 Months</wa-menu-item>
+      <wa-menu-item value="capitalize">12 Months</wa-menu-item>
+    </wa-menu>
+      </wa-menu-item>
+      <wa-menu-item value="orange">Big & Tall</wa-menu-item>
+    </div>
+  <div>
+    <wa-menu-label>Shop by Category</wa-menu-label>
+    <wa-menu-item value="apple">Shirts</wa-menu-item>
+    <wa-menu-item value="banana">Pants</wa-menu-item>
+    <wa-menu-item value="orange">Shoes</wa-menu-item>
+  </div>
+
+  <div>
+    <wa-menu-label>Just Arrived</wa-menu-label>
+
+
+    <wa-menu-item>
+      <a href="#">
+       <img style="width: 100%; max-width: 200px;" src="https://images.unsplash.com/photo-1523381294911-8d3cead13475?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=M3w1OTAyOTl8MHwxfGFsbHx8fHx8fHx8fDE3MTg2NDIzNDd8&ixlib=rb-4.0.3&q=80&w=1080" />
+     </a>
+
+    </wa-menu-item>
+
+
+
+  </div>
+
+
+    <wa-menu-item style="grid-column: 1/-1;">
+      <div style="display: flex; justify-content: space-between; align-items: center;">
+        <p style="margin:0;">footer with something cool in it</p>
+        <wa-button variant="brand" size="small">Signup now</wa-button>
+      </div>
+
+    </wa-menu-item>
+
+  </wa-menu>
+
+
+</wa-dropdown>
+<style>
+  .mm-grid {
+        display: grid;
+    grid-template-columns: repeat(3, auto);
+    gap: 1rem;
+
+
+
+  .card-overview small {
+    color: var(--wa-color-text-quiet);
+  }
+
+  .card-overview [slot='footer'] {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+  }
+  }
+
+
+</style>
+```

docs/docs/patterns/ecommerce.njk

@@ -0,0 +1,26 @@
+---
+title: E-commerce
+description: ''
+layout: page
+---
+
+{% set ecommercePages = collections['e-commerce'] %}
+
+<section class="index-grid">
+    {%- for page in ecommercePages -%}
+
+    <a href="{{ page.url }}"{{ page.data.keywords | attr('data-keywords') }}>
+        <wa-card with-header>
+            <div slot="header">
+                {% include "svgs/" + (page.data.icon or "thumbnail-placeholder") + ".njk" %}
+            </div>
+            <span class="page-name">{{ page.data.title }}</span>
+            {% if pageSubtitle -%}
+            <div class="wa-caption-s">{{ pageSubtitle }}</div>
+            {%- endif %}
+        </wa-card>
+    </a>
+
+    {%- endfor -%}
+
+</section>

docs/docs/patterns/education.md

@@ -1,6 +1,7 @@
 ---
 title: Business
 description: TODO
+unlisted: true
 ---
 
 TODO Page Description

docs/docs/patterns/entertainement.md

@@ -1,6 +1,7 @@
 ---
 title: Entertainment
 description: TODO
+unlisted: true
 ---
 
 TODO Page Description

docs/docs/patterns/index.njk

@@ -1,8 +1,29 @@
 ---
 title: Patterns
-description: Patterns are reusable solutions to common design problems.
+description: Patterns are reusable UI solutions to common design problems, ready to copy and paste into any project.
 layout: overview
 categories: ["e-commerce"]
 listChildren: true
 override:tags: []
 ---
+
+<div class="max-line-length">
+{% markdown %}
+
+## What's a Pattern?
+
+A pattern is a code snippet composed of components, style utilities, and native HTML that you can copy and paste into any project that uses Web Awesome. 
+It's a chunk of a user interface, rather than a single component, that allows you to implement UI solutions without designing something from scratch.
+
+Patterns are designed according to proven usability practices so they're responsive, accessible, and cohesive out-of-the-box. Importantly, patterns don't handle business logic or functionality like form submissions, data processing, encryption, etc. It's up to you to implement the logic you need for your project.
+
+Patterns are written as standard HTML, so you can use them just as you would any ol' HTML and customize them to fit your specific needs.
+
+## Using Patterns
+
+To use a pattern in your project, refer to each pattern's docs for a copyable code snippet. Paste the snippet wherever you'd like the pattern to appear in your project.
+
+Because patterns use a combination of Web Awesome features, they work best when you have [native styles](/docs/native), [style utilities](/docs/utilities), and a [theme](/docs/themes) installed in addition to Web Awesome [components](/docs/components). Refer to the [Installation page](/docs/installation) to set up all of these features in your project.
+
+{% endmarkdown %}
+</div>

docs/docs/patterns/membership.md

@@ -1,6 +1,7 @@
 ---
 title: Membership
 description: TODO
+unlisted: true
 ---
 
 TODO Page Description

docs/docs/patterns/news.md

@@ -1,6 +1,7 @@
 ---
 title: News
 description: TODO
+unlisted: true
 ---
 
 TODO Page Description

docs/docs/patterns/non-profit.md

@@ -1,6 +1,7 @@
 ---
 title: Non-profit
 description: TODO
+unlisted: true
 ---
 
 TODO Page Description

docs/docs/patterns/patterns.css

@@ -0,0 +1,7 @@
+.anchor-heading:has(+ wa-code-demo, + template + wa-code-demo) {
+  font-size: var(--wa-font-size-l);
+}
+
+wa-code-demo:has(+ .anchor-heading) {
+  margin-block-end: var(--wa-space-3xl);
+}

docs/docs/patterns/patterns.json

@@ -1,5 +1,5 @@
 {
-  "layout": "block.njk",
+  "layout": "patterns.njk",
   "tags": ["patterns"],
   "wide": true,
   "noAlpha": true

docs/docs/patterns/portfolio.md

@@ -1,6 +1,7 @@
 ---
 title: Portfolio
 description: TODO
+unlisted: true
 ---
 
 TODO Page Description

docs/docs/patterns/product-landing.md

@@ -1,6 +1,7 @@
 ---
 title: Product Landing
 description: TODO
+unlisted: true
 ---
 
 TODO Page Description

src/styles/utilities.css

@@ -1,6 +1,7 @@
 @import url('utilities/fouce.css');
 @import url('utilities/visually-hidden.css');
 @import url('utilities/scroll-lock.css');
+@import url('utilities/placeholder.css');
 @import url('utilities/align-items.css');
 @import url('utilities/border-radius.css');
 @import url('utilities/gap.css');

src/styles/utilities/placeholder.css

@@ -0,0 +1,7 @@
+.wa-placeholder {
+  align-self: stretch;
+  background-color: var(--wa-color-neutral-fill-quiet);
+  border: dashed var(--wa-border-width-s) var(--wa-color-neutral-border-normal);
+  border-radius: var(--wa-border-radius-l);
+  padding: var(--wa-space-3xl);
+}

src/styles/utilities/text.css

@@ -99,3 +99,25 @@
 .wa-caption-xl {
   font-size: var(--wa-font-size-l);
 }
+
+.wa-link {
+  color: var(--wa-color-text-link);
+  text-decoration: var(--wa-link-decoration-default);
+  -webkit-text-decoration: var(--wa-link-decoration-default);
+
+  &:hover {
+    color: color-mix(in oklab, var(--wa-color-text-link) 100%, var(--wa-color-mix-hover));
+    text-decoration: var(--wa-link-decoration-hover);
+    -webkit-text-decoration: var(--wa-link-decoration-hover);
+  }
+}
+
+.wa-link-plain {
+  color: var(--wa-color-text-normal);
+  text-decoration: none;
+
+  &:hover {
+    color: color-mix(in oklab, currentColor, var(--wa-color-mix-hover));
+    text-decoration: none;
+  }
+}