<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="4.4.1">Jekyll</generator><link href="https://goodbran.com/feed.xml" rel="self" type="application/atom+xml" /><link href="https://goodbran.com/" rel="alternate" type="text/html" /><updated>2026-11-17T02:36:10+00:00</updated><id>https://goodbran.com/feed.xml</id><title type="html">Goodbran</title><subtitle>Writing, publishing, and sharing notes. A personal blog about coding, music, and creativity.</subtitle><entry><title type="html">Test the Real Network Before the Event</title><link href="https://goodbran.com/2026/06/15/test-the-real-network-before-the-event/" rel="alternate" type="text/html" title="Test the Real Network Before the Event" /><published>2026-06-15T04:00:00+00:00</published><updated>2026-06-15T04:00:00+00:00</updated><id>https://goodbran.com/2026/06/15/test-the-real-network-before-the-event</id><content type="html" xml:base="https://goodbran.com/2026/06/15/test-the-real-network-before-the-event/"><![CDATA[<p>Always test the project in the real network environment before the event. A web app can look perfect at home, pass every local test, and still fail in the room where it actually needs to work.</p>

<p>I recently generated a simple web app for my kids’ kindergarten school project: <a href="https://github.com/OpenKids/caterpillar">OpenKids Caterpillar</a>. The app looked good. The interactions felt good. We even recorded several sound effects with my kids, which made the little presentation feel personal and fun.</p>

<p>Then the actual event happened.</p>

<p>The deployment was on GitHub Pages, and GitHub is not well supported in China. The loading speed was painfully slow. The sound effects, which were one of the best parts of the project, could not load at all.</p>

<p>Technically, nothing was broken in the app. Practically, the experience was broken.</p>

<p>That was the lesson.</p>

<p>For the next presentation project, <a href="https://github.com/OpenKids/crocodile">OpenKids Crocodile</a>, I wanted to introduce World Crocodile Day and avoid repeating the same mistake. This time I planned to use Cloudflare Pages instead of GitHub Pages.</p>

<p>Luckily, because of the previous failure, I tested it from a normal non-VPN network before the event.</p>

<p>That test found another problem: the default free Cloudflare Pages endpoint uses the <code class="language-plaintext highlighter-rouge">*.workers.dev</code> domain, and that domain was completely blocked by the China firewall in my test environment. If I had only tested from my usual development setup, I probably would have missed it.</p>

<p>Because I found the issue early, the fix was simple. I added a custom domain for the project, tested again, and it worked.</p>

<p>The takeaway is simple: deployment is part of the product, especially for a presentation. Do not only test the app. Test the URL, the assets, the audio, and the exact network conditions where people will use it.</p>]]></content><author><name></name></author><category term="code" /><summary type="html"><![CDATA[A short lesson from two school presentation web apps: always test deployment from the real network before the event.]]></summary></entry><entry><title type="html">Remembering Corner</title><link href="https://goodbran.com/2026/06/01/remembering-corner/" rel="alternate" type="text/html" title="Remembering Corner" /><published>2026-06-01T04:00:00+00:00</published><updated>2026-06-01T04:00:00+00:00</updated><id>https://goodbran.com/2026/06/01/remembering-corner</id><content type="html" xml:base="https://goodbran.com/2026/06/01/remembering-corner/"><![CDATA[<p>Corner was with us from February 2017 to May 2026.</p>

<p>She got her name because, when I first met her, she was very afraid of people. She would hide inside the corner of the sofa, watching the world from the safest place she could find. So she became Corner.</p>

<p>Over time, that little hiding place became part of her story, not all of it. She grew into a quiet, familiar presence at home, the kind that made ordinary days feel softer.</p>

<p>Goodbye, Corner. Thank you for the years, the trust, and the gentle company.</p>

<p><img src="/assets/images/corner_2017-2026/1.JPG" alt="Corner resting" /></p>

<p><img src="/assets/images/corner_2017-2026/2.JPG" alt="Corner looking calm" /></p>

<p><img src="/assets/images/corner_2017-2026/3.jpg" alt="Corner at home" /></p>

<p><img src="/assets/images/corner_2017-2026/4.jpg" alt="Corner remembered" /></p>]]></content><author><name></name></author><category term="life" /><summary type="html"><![CDATA[A short goodbye to Corner, my cat, who was with us from February 2017 to May 2026.]]></summary></entry><entry><title type="html">Cheap AI Models on AWS Bedrock: A Small Email Classification Test</title><link href="https://goodbran.com/2026/05/18/cheap-ai-models-on-aws-bedrock/" rel="alternate" type="text/html" title="Cheap AI Models on AWS Bedrock: A Small Email Classification Test" /><published>2026-05-18T04:00:00+00:00</published><updated>2026-05-18T04:00:00+00:00</updated><id>https://goodbran.com/2026/05/18/cheap-ai-models-on-aws-bedrock</id><content type="html" xml:base="https://goodbran.com/2026/05/18/cheap-ai-models-on-aws-bedrock/"><![CDATA[<p>This is a simple experiment classifying 20 email subjects using cheap AI models available on AWS Bedrock. The goal is to see how they perform on a basic, high-volume production task.</p>

<h2 id="models-tested">Models Tested</h2>

<table>
  <thead>
    <tr>
      <th>Model</th>
      <th>Bedrock ID</th>
      <th style="text-align: right">Input / 1M</th>
      <th style="text-align: right">Output / 1M</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>MiniMax M2.5</td>
      <td><code class="language-plaintext highlighter-rouge">minimax.minimax-m2.5</code></td>
      <td style="text-align: right">$0.30</td>
      <td style="text-align: right">$1.20</td>
    </tr>
    <tr>
      <td>Google Gemma 3 12B IT</td>
      <td><code class="language-plaintext highlighter-rouge">google.gemma-3-12b-it</code></td>
      <td style="text-align: right">$0.09</td>
      <td style="text-align: right">$0.29</td>
    </tr>
    <tr>
      <td>Google Gemma 3 4B IT</td>
      <td><code class="language-plaintext highlighter-rouge">google.gemma-3-4b-it</code></td>
      <td style="text-align: right">$0.09</td>
      <td style="text-align: right">$0.29</td>
    </tr>
    <tr>
      <td>Ministral 14B 3.0</td>
      <td><code class="language-plaintext highlighter-rouge">mistral.ministral-3-14b-instruct</code></td>
      <td style="text-align: right">$0.20</td>
      <td style="text-align: right">$0.20</td>
    </tr>
    <tr>
      <td>Claude Haiku 4.5</td>
      <td><code class="language-plaintext highlighter-rouge">us.anthropic.claude-haiku-4-5-20251001-v1:0</code></td>
      <td style="text-align: right">$1.00</td>
      <td style="text-align: right">$5.00</td>
    </tr>
  </tbody>
</table>

<h2 id="summary">Summary</h2>

<table>
  <thead>
    <tr>
      <th>Model</th>
      <th style="text-align: right">Accuracy</th>
      <th style="text-align: right">Input Tokens</th>
      <th style="text-align: right">Output Tokens</th>
      <th style="text-align: right">Estimated Cost</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>Ministral 14B 3.0</td>
      <td style="text-align: right">20/20</td>
      <td style="text-align: right">8,078</td>
      <td style="text-align: right">505</td>
      <td style="text-align: right">$0.001717</td>
    </tr>
    <tr>
      <td>Claude Haiku 4.5</td>
      <td style="text-align: right">20/20</td>
      <td style="text-align: right">20,845</td>
      <td style="text-align: right">1,127</td>
      <td style="text-align: right">$0.026480</td>
    </tr>
    <tr>
      <td>MiniMax M2.5</td>
      <td style="text-align: right">19/20</td>
      <td style="text-align: right">10,310</td>
      <td style="text-align: right">4,489</td>
      <td style="text-align: right">$0.008480</td>
    </tr>
    <tr>
      <td>Google Gemma 3 12B IT</td>
      <td style="text-align: right">18/20</td>
      <td style="text-align: right">4,146</td>
      <td style="text-align: right">263</td>
      <td style="text-align: right">$0.000449</td>
    </tr>
    <tr>
      <td>Google Gemma 3 4B IT</td>
      <td style="text-align: right">17/20</td>
      <td style="text-align: right">4,146</td>
      <td style="text-align: right">256</td>
      <td style="text-align: right">$0.000447</td>
    </tr>
  </tbody>
</table>

<h2 id="takeaways">Takeaways</h2>

<ul>
  <li><strong>Ministral 14B</strong> offers the best balance of cost and perfect accuracy for this task.</li>
</ul>

<h2 id="raw-results">Raw Results</h2>

<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>MiniMax M2.5 (minimax.minimax-m2.5)
--------------------------------------------------------------------------------
 1. PASS Invoice for April Campaign Spend                     expected=Finance / Invoice                            actual=Finance / Invoice
 2. PASS Billing Confirmation - May Media Buy                 expected=Finance / Billing Confirmation               actual=Finance / Billing Confirmation
 3. PASS Payment Received for March Invoice                   expected=Finance / Payment Received                   actual=Finance / Payment Received
 4. PASS Vendor Payout Summary - Q2                           expected=Finance / Vendor Payout                      actual=Finance / Vendor Payout
 5. PASS Overdue Payment Reminder for April Invoice           expected=Finance / Overdue Payment                    actual=Finance / Overdue Payment
 6. PASS Campaign Launch - ABC App - US Android               expected=Campaign / Launch                            actual=Campaign / Launch
 7. PASS Relaunch Request for iOS Campaign                    expected=Campaign / Relaunch                          actual=Campaign / Relaunch
 8. PASS Campaign Adjustment: Increase Daily Cap              expected=Campaign / Adjustment                        actual=Campaign / Adjustment
 9. PASS Pause Notice - Low ROAS Campaign                     expected=Campaign / Pause Notice                      actual=Campaign / Pause Notice
10. PASS New Campaign Opportunity - Finance App               expected=Campaign / Opportunity                       actual=Campaign / Opportunity
11. PASS Scheduled Performance Report - Weekly Summary        expected=Reporting / Scheduled Report                 actual=Reporting / Scheduled Report
12. PASS Query Failed for Scheduled Report                    expected=Reporting / Report Failure                   actual=Reporting / Report Failure
13. PASS Ad Spend Upload Status - May 2026                    expected=Reporting / Upload Status                    actual=Reporting / Upload Status
14. PASS Monthly Campaign Performance Dashboard               expected=Reporting / Performance Dashboard            actual=Reporting / Performance Dashboard
15. PASS Tracking Link Update Required                        expected=Technical / Tracking Link                    actual=Technical / Tracking Link
16. PASS Missing Events in AppsFlyer                          expected=Technical / Missing Events                   actual=Technical / Missing Events
17. PASS Impression Link Update for New Creative              expected=Technical / Impression Link                  actual=Technical / Impression Link
18. PASS Postback Issue on Android Campaign                   expected=Technical / Postback Issue                   actual=Technical / Postback Issue
19. FAIL Meeting Follow-Up from Business of Apps              expected=Other / Admin / Meeting Follow-Up            actual=nil
20. PASS Test Email - Please Ignore                           expected=Other / Admin / Test / Noise                 actual=Other / Admin / Test / Noise
Accuracy: 19/20
Tokens: input=10310, output=4489
Estimated cost: $0.008480

Google Gemma 3 12B IT (google.gemma-3-12b-it)
--------------------------------------------------------------------------------
 1. PASS Invoice for April Campaign Spend                     expected=Finance / Invoice                            actual=Finance / Invoice
 2. PASS Billing Confirmation - May Media Buy                 expected=Finance / Billing Confirmation               actual=Finance / Billing Confirmation
 3. PASS Payment Received for March Invoice                   expected=Finance / Payment Received                   actual=Finance / Payment Received
 4. PASS Vendor Payout Summary - Q2                           expected=Finance / Vendor Payout                      actual=Finance / Vendor Payout
 5. PASS Overdue Payment Reminder for April Invoice           expected=Finance / Overdue Payment                    actual=Finance / Overdue Payment
 6. PASS Campaign Launch - ABC App - US Android               expected=Campaign / Launch                            actual=Campaign / Launch
 7. PASS Relaunch Request for iOS Campaign                    expected=Campaign / Relaunch                          actual=Campaign / Relaunch
 8. PASS Campaign Adjustment: Increase Daily Cap              expected=Campaign / Adjustment                        actual=Campaign / Adjustment
 9. PASS Pause Notice - Low ROAS Campaign                     expected=Campaign / Pause Notice                      actual=Campaign / Pause Notice
10. PASS New Campaign Opportunity - Finance App               expected=Campaign / Opportunity                       actual=Campaign / Opportunity
11. PASS Scheduled Performance Report - Weekly Summary        expected=Reporting / Scheduled Report                 actual=Reporting / Scheduled Report
12. PASS Query Failed for Scheduled Report                    expected=Reporting / Report Failure                   actual=Reporting / Report Failure
13. PASS Ad Spend Upload Status - May 2026                    expected=Reporting / Upload Status                    actual=Reporting / Upload Status
14. PASS Monthly Campaign Performance Dashboard               expected=Reporting / Performance Dashboard            actual=Reporting / Performance Dashboard
15. PASS Tracking Link Update Required                        expected=Technical / Tracking Link                    actual=Technical / Tracking Link
16. PASS Missing Events in AppsFlyer                          expected=Technical / Missing Events                   actual=Technical / Missing Events
17. PASS Impression Link Update for New Creative              expected=Technical / Impression Link                  actual=Technical / Impression Link
18. PASS Postback Issue on Android Campaign                   expected=Technical / Postback Issue                   actual=Technical / Postback Issue
19. FAIL Meeting Follow-Up from Business of Apps              expected=Other / Admin / Meeting Follow-Up            actual=nil
20. FAIL Test Email - Please Ignore                           expected=Other / Admin / Test / Noise                 actual=nil
Accuracy: 18/20
Tokens: input=4146, output=263
Estimated cost: $0.000449

Google Gemma 3 4B IT (google.gemma-3-4b-it)
--------------------------------------------------------------------------------
 1. PASS Invoice for April Campaign Spend                     expected=Finance / Invoice                            actual=Finance / Invoice
 2. PASS Billing Confirmation - May Media Buy                 expected=Finance / Billing Confirmation               actual=Finance / Billing Confirmation
 3. PASS Payment Received for March Invoice                   expected=Finance / Payment Received                   actual=Finance / Payment Received
 4. PASS Vendor Payout Summary - Q2                           expected=Finance / Vendor Payout                      actual=Finance / Vendor Payout
 5. PASS Overdue Payment Reminder for April Invoice           expected=Finance / Overdue Payment                    actual=Finance / Overdue Payment
 6. PASS Campaign Launch - ABC App - US Android               expected=Campaign / Launch                            actual=Campaign / Launch
 7. PASS Relaunch Request for iOS Campaign                    expected=Campaign / Relaunch                          actual=Campaign / Relaunch
 8. PASS Campaign Adjustment: Increase Daily Cap              expected=Campaign / Adjustment                        actual=Campaign / Adjustment
 9. PASS Pause Notice - Low ROAS Campaign                     expected=Campaign / Pause Notice                      actual=Campaign / Pause Notice
10. PASS New Campaign Opportunity - Finance App               expected=Campaign / Opportunity                       actual=Campaign / Opportunity
11. PASS Scheduled Performance Report - Weekly Summary        expected=Reporting / Scheduled Report                 actual=Reporting / Scheduled Report
12. PASS Query Failed for Scheduled Report                    expected=Reporting / Report Failure                   actual=Reporting / Report Failure
13. PASS Ad Spend Upload Status - May 2026                    expected=Reporting / Upload Status                    actual=Reporting / Upload Status
14. PASS Monthly Campaign Performance Dashboard               expected=Reporting / Performance Dashboard            actual=Reporting / Performance Dashboard
15. PASS Tracking Link Update Required                        expected=Technical / Tracking Link                    actual=Technical / Tracking Link
16. PASS Missing Events in AppsFlyer                          expected=Technical / Missing Events                   actual=Technical / Missing Events
17. FAIL Impression Link Update for New Creative              expected=Technical / Impression Link                  actual=nil
18. PASS Postback Issue on Android Campaign                   expected=Technical / Postback Issue                   actual=Technical / Postback Issue
19. FAIL Meeting Follow-Up from Business of Apps              expected=Other / Admin / Meeting Follow-Up            actual=nil
20. FAIL Test Email - Please Ignore                           expected=Other / Admin / Test / Noise                 actual=nil
Accuracy: 17/20
Tokens: input=4146, output=256
Estimated cost: $0.000447

Ministral 14B 3.0 (mistral.ministral-3-14b-instruct)
--------------------------------------------------------------------------------
 1. PASS Invoice for April Campaign Spend                     expected=Finance / Invoice                            actual=Finance / Invoice
 2. PASS Billing Confirmation - May Media Buy                 expected=Finance / Billing Confirmation               actual=Finance / Billing Confirmation
 3. PASS Payment Received for March Invoice                   expected=Finance / Payment Received                   actual=Finance / Payment Received
 4. PASS Vendor Payout Summary - Q2                           expected=Finance / Vendor Payout                      actual=Finance / Vendor Payout
 5. PASS Overdue Payment Reminder for April Invoice           expected=Finance / Overdue Payment                    actual=Finance / Overdue Payment
 6. PASS Campaign Launch - ABC App - US Android               expected=Campaign / Launch                            actual=Campaign / Launch
 7. PASS Relaunch Request for iOS Campaign                    expected=Campaign / Relaunch                          actual=Campaign / Relaunch
 8. PASS Campaign Adjustment: Increase Daily Cap              expected=Campaign / Adjustment                        actual=Campaign / Adjustment
 9. PASS Pause Notice - Low ROAS Campaign                     expected=Campaign / Pause Notice                      actual=Campaign / Pause Notice
10. PASS New Campaign Opportunity - Finance App               expected=Campaign / Opportunity                       actual=Campaign / Opportunity
11. PASS Scheduled Performance Report - Weekly Summary        expected=Reporting / Scheduled Report                 actual=Reporting / Scheduled Report
12. PASS Query Failed for Scheduled Report                    expected=Reporting / Report Failure                   actual=Reporting / Report Failure
13. PASS Ad Spend Upload Status - May 2026                    expected=Reporting / Upload Status                    actual=Reporting / Upload Status
14. PASS Monthly Campaign Performance Dashboard               expected=Reporting / Performance Dashboard            actual=Reporting / Performance Dashboard
15. PASS Tracking Link Update Required                        expected=Technical / Tracking Link                    actual=Technical / Tracking Link
16. PASS Missing Events in AppsFlyer                          expected=Technical / Missing Events                   actual=Technical / Missing Events
17. PASS Impression Link Update for New Creative              expected=Technical / Impression Link                  actual=Technical / Impression Link
18. PASS Postback Issue on Android Campaign                   expected=Technical / Postback Issue                   actual=Technical / Postback Issue
19. PASS Meeting Follow-Up from Business of Apps              expected=Other / Admin / Meeting Follow-Up            actual=Other / Admin / Meeting Follow-Up
20. PASS Test Email - Please Ignore                           expected=Other / Admin / Test / Noise                 actual=Other / Admin / Test / Noise
Accuracy: 20/20
Tokens: input=8078, output=505
Estimated cost: $0.001717

Haiku 4.5 (us.anthropic.claude-haiku-4-5-20251001-v1:0)
--------------------------------------------------------------------------------
 1. PASS Invoice for April Campaign Spend                     expected=Finance / Invoice                            actual=Finance / Invoice
 2. PASS Billing Confirmation - May Media Buy                 expected=Finance / Billing Confirmation               actual=Finance / Billing Confirmation
 3. PASS Payment Received for March Invoice                   expected=Finance / Payment Received                   actual=Finance / Payment Received
 4. PASS Vendor Payout Summary - Q2                           expected=Finance / Vendor Payout                      actual=Finance / Vendor Payout
 5. PASS Overdue Payment Reminder for April Invoice           expected=Finance / Overdue Payment                    actual=Finance / Overdue Payment
 6. PASS Campaign Launch - ABC App - US Android               expected=Campaign / Launch                            actual=Campaign / Launch
 7. PASS Relaunch Request for iOS Campaign                    expected=Campaign / Relaunch                          actual=Campaign / Relaunch
 8. PASS Campaign Adjustment: Increase Daily Cap              expected=Campaign / Adjustment                        actual=Campaign / Adjustment
 9. PASS Pause Notice - Low ROAS Campaign                     expected=Campaign / Pause Notice                      actual=Campaign / Pause Notice
10. PASS New Campaign Opportunity - Finance App               expected=Campaign / Opportunity                       actual=Campaign / Opportunity
11. PASS Scheduled Performance Report - Weekly Summary        expected=Reporting / Scheduled Report                 actual=Reporting / Scheduled Report
12. PASS Query Failed for Scheduled Report                    expected=Reporting / Report Failure                   actual=Reporting / Report Failure
13. PASS Ad Spend Upload Status - May 2026                    expected=Reporting / Upload Status                    actual=Reporting / Upload Status
14. PASS Monthly Campaign Performance Dashboard               expected=Reporting / Performance Dashboard            actual=Reporting / Performance Dashboard
15. PASS Tracking Link Update Required                        expected=Technical / Tracking Link                    actual=Technical / Tracking Link
16. PASS Missing Events in AppsFlyer                          expected=Technical / Missing Events                   actual=Technical / Missing Events
17. PASS Impression Link Update for New Creative              expected=Technical / Impression Link                  actual=Technical / Impression Link
18. PASS Postback Issue on Android Campaign                   expected=Technical / Postback Issue                   actual=Technical / Postback Issue
19. PASS Meeting Follow-Up from Business of Apps              expected=Other / Admin / Meeting Follow-Up            actual=Other / Admin / Meeting Follow-Up
20. PASS Test Email - Please Ignore                           expected=Other / Admin / Test / Noise                 actual=Other / Admin / Test / Noise
Accuracy: 20/20
Tokens: input=20845, output=1127
Estimated cost: $0.026480
</code></pre></div></div>]]></content><author><name></name></author><category term="code" /><summary type="html"><![CDATA[A quick AWS Bedrock experiment comparing low-cost models on a simple email subject classification task.]]></summary></entry><entry><title type="html">Object Position</title><link href="https://goodbran.com/2026/05/06/object-position/" rel="alternate" type="text/html" title="Object Position" /><published>2026-05-06T05:00:00+00:00</published><updated>2026-05-06T05:00:00+00:00</updated><id>https://goodbran.com/2026/05/06/object-position</id><content type="html" xml:base="https://goodbran.com/2026/05/06/object-position/"><![CDATA[<p>Object position starts with one question: which point on the object are you placing?</p>

<p>If you place a star with <code class="language-plaintext highlighter-rouge">top</code> and <code class="language-plaintext highlighter-rouge">left</code>, CSS places the star’s top-left corner. If you want the whole star to stay inside a frame, place its center inside a smaller inner frame.</p>

<p>This post is about positioning objects in a layout. CSS also has an <code class="language-plaintext highlighter-rouge">object-position</code> property for images and videos, but the idea here is lower level: choose an anchor point, then choose the area where that anchor point is allowed to move.</p>

<h2 id="the-result">The Result</h2>

<p>Click the button a few times. Each star gets a random position, but it never spills outside the outer frame.</p>

<section class="code-playground" data-code-playground="" style="--playground-height: 430px;">
  <div class="code-playground__header">
    <h3 class="code-playground__title">Object Position</h3>
    <div class="code-playground__tabs" role="tablist" aria-label="Switch code playground view">
      <button class="code-playground__tab is-active" type="button" role="tab" aria-selected="true" data-playground-tab="preview">Preview</button>
      <button class="code-playground__tab" type="button" role="tab" aria-selected="false" data-playground-tab="html">HTML</button>
      
        <button class="code-playground__tab" type="button" role="tab" aria-selected="false" data-playground-tab="css">CSS</button>
      
      
        <button class="code-playground__tab" type="button" role="tab" aria-selected="false" data-playground-tab="js">JS</button>
      
    </div>
  </div>

  <div class="code-playground__body">
    <div class="code-playground__panel is-active" role="tabpanel" data-playground-panel="preview">
      <iframe class="code-playground__preview" title="Object Position preview" sandbox="allow-scripts" loading="lazy" srcdoc="&lt;!doctype html&gt;
&lt;html lang=&quot;en&quot;&gt;
&lt;head&gt;
  &lt;meta charset=&quot;utf-8&quot;&gt;
  &lt;meta name=&quot;viewport&quot; content=&quot;width=device-width, initial-scale=1&quot;&gt;
  &lt;style&gt;
    *,
    *::before,
    *::after {
      box-sizing: border-box;
    }

    *:not(dialog) {
      margin: 0;
    }

    @media (prefers-reduced-motion: no-preference) {
      html {
        interpolate-size: allow-keywords;
      }
    }

    body {
      display: grid;
      place-items: center;
      min-height: 100vh;
      padding: 1rem;
      color: #15141a;
      background: #ffffff;
      font-family: Inter, -apple-system, BlinkMacSystemFont, &quot;Segoe UI&quot;, sans-serif;
      line-height: 1.5;
      -webkit-font-smoothing: antialiased;
    }

    img,
    picture,
    video,
    canvas,
    svg {
      display: block;
      max-width: 100%;
    }

    input,
    button,
    textarea,
    select {
      font: inherit;
    }

    p,
    h1,
    h2,
    h3,
    h4,
    h5,
    h6 {
      overflow-wrap: break-word;
    }

    p {
      text-wrap: pretty;
    }

    h1,
    h2,
    h3,
    h4,
    h5,
    h6 {
      text-wrap: balance;
    }

    #root,
    #__next {
      isolation: isolate;
    }


.objectPositionDemo {
  display: grid;
  gap: 1rem;
  justify-items: center;
  width: min(100%, 34rem);
}

.starFrame {
  --star-size: 2rem;

  position: relative;
  width: min(100%, 30rem);
  aspect-ratio: 16 / 9;
  overflow: hidden;
  border: 3px solid hsl(230deg 25% 18%);
  border-radius: 1.25rem;
  background:
    radial-gradient(circle at 20% 20%, hsl(230deg 80% 35% / 0.45), transparent 32%),
    radial-gradient(circle at 80% 10%, hsl(280deg 70% 38% / 0.35), transparent 30%),
    linear-gradient(135deg, hsl(230deg 50% 12%), hsl(250deg 52% 18%));
  box-shadow: 0 1rem 2.5rem hsl(230deg 40% 12% / 0.22);
}

.innerFrame {
  position: absolute;
  inset: calc(var(--star-size) / 2);
  border: 1px dashed hsl(48deg 100% 80% / 0.5);
  border-radius: 0.8rem;
}

.star {
  position: absolute;
  top: var(--top);
  left: var(--left);
  display: grid;
  place-items: center;
  width: var(--star-size);
  height: var(--star-size);
  color: hsl(48deg 100% 64%);
  font-size: var(--star-size);
  line-height: 1;
  pointer-events: none;
  text-shadow: 0 0 0.8rem hsl(48deg 100% 70% / 0.8);
  transform: translate(-50%, -50%) scale(0.6);
  animation: star-pop 180ms ease-out forwards;
}

.addStarButton {
  border: 0;
  border-radius: 999px;
  padding: 0.75rem 1.1rem;
  background: hsl(48deg 100% 58%);
  color: hsl(230deg 40% 14%);
  cursor: pointer;
  font-weight: 800;
  box-shadow: 0 0.55rem 1.2rem hsl(48deg 100% 40% / 0.25);
}

.addStarButton:focus-visible {
  outline: 3px solid hsl(48deg 100% 78% / 0.8);
  outline-offset: 4px;
}

@keyframes star-pop {
  to {
    transform: translate(-50%, -50%) scale(1);
  }
}

  &lt;/style&gt;
&lt;/head&gt;
&lt;body&gt;

&lt;div class=&quot;objectPositionDemo&quot;&gt;
  &lt;div class=&quot;starFrame&quot; role=&quot;img&quot; aria-label=&quot;A frame that fills with decorative stars&quot;&gt;
    &lt;div class=&quot;innerFrame&quot; data-star-stage aria-hidden=&quot;true&quot;&gt;&lt;/div&gt;
  &lt;/div&gt;

  &lt;button class=&quot;addStarButton&quot; type=&quot;button&quot; data-add-star&gt;Add a star&lt;/button&gt;
&lt;/div&gt;


  &lt;script&gt;

const stage = document.querySelector(&quot;[data-star-stage]&quot;);
const button = document.querySelector(&quot;[data-add-star]&quot;);

function randomPercent() {
  return Math.round(Math.random() * 10000) / 100;
}

function addStar() {
  const star = document.createElement(&quot;span&quot;);

  star.className = &quot;star&quot;;
  star.style.setProperty(&quot;--top&quot;, randomPercent() + &quot;%&quot;);
  star.style.setProperty(&quot;--left&quot;, randomPercent() + &quot;%&quot;);
  star.innerHTML = &quot;&amp;#9733;&quot;;

  stage.appendChild(star);
}

button.addEventListener(&quot;click&quot;, addStar);

  &lt;/script&gt;

&lt;/body&gt;
&lt;/html&gt;"></iframe>
    </div>

    <div class="code-playground__panel" role="tabpanel" data-playground-panel="html" hidden="">
      <div class="code-playground__source">
<figure class="highlight"><pre><code class="language-html" data-lang="html"><span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"objectPositionDemo"</span><span class="nt">&gt;</span>
  <span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"starFrame"</span> <span class="na">role=</span><span class="s">"img"</span> <span class="na">aria-label=</span><span class="s">"A frame that fills with decorative stars"</span><span class="nt">&gt;</span>
    <span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"innerFrame"</span> <span class="na">data-star-stage</span> <span class="na">aria-hidden=</span><span class="s">"true"</span><span class="nt">&gt;&lt;/div&gt;</span>
  <span class="nt">&lt;/div&gt;</span>

  <span class="nt">&lt;button</span> <span class="na">class=</span><span class="s">"addStarButton"</span> <span class="na">type=</span><span class="s">"button"</span> <span class="na">data-add-star</span><span class="nt">&gt;</span>Add a star<span class="nt">&lt;/button&gt;</span>
<span class="nt">&lt;/div&gt;</span></code></pre></figure>
</div>
    </div>

    
      <div class="code-playground__panel" role="tabpanel" data-playground-panel="css" hidden="">
        <div class="code-playground__source">
<figure class="highlight"><pre><code class="language-css" data-lang="css"><span class="nc">.objectPositionDemo</span> <span class="p">{</span>
  <span class="nl">display</span><span class="p">:</span> <span class="nb">grid</span><span class="p">;</span>
  <span class="nl">gap</span><span class="p">:</span> <span class="m">1rem</span><span class="p">;</span>
  <span class="nl">justify-items</span><span class="p">:</span> <span class="nb">center</span><span class="p">;</span>
  <span class="nl">width</span><span class="p">:</span> <span class="nf">min</span><span class="p">(</span><span class="m">100%</span><span class="p">,</span> <span class="m">34rem</span><span class="p">);</span>
<span class="p">}</span>

<span class="nc">.starFrame</span> <span class="p">{</span>
  <span class="py">--star-size</span><span class="p">:</span> <span class="m">2rem</span><span class="p">;</span>

  <span class="nl">position</span><span class="p">:</span> <span class="nb">relative</span><span class="p">;</span>
  <span class="nl">width</span><span class="p">:</span> <span class="nf">min</span><span class="p">(</span><span class="m">100%</span><span class="p">,</span> <span class="m">30rem</span><span class="p">);</span>
  <span class="nl">aspect-ratio</span><span class="p">:</span> <span class="m">16</span> <span class="o">/</span> <span class="m">9</span><span class="p">;</span>
  <span class="nl">overflow</span><span class="p">:</span> <span class="nb">hidden</span><span class="p">;</span>
  <span class="nl">border</span><span class="p">:</span> <span class="m">3px</span> <span class="nb">solid</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">230deg</span> <span class="m">25%</span> <span class="m">18%</span><span class="p">);</span>
  <span class="nl">border-radius</span><span class="p">:</span> <span class="m">1.25rem</span><span class="p">;</span>
  <span class="nl">background</span><span class="p">:</span>
    <span class="nf">radial-gradient</span><span class="p">(</span><span class="nb">circle</span> <span class="n">at</span> <span class="m">20%</span> <span class="m">20%</span><span class="p">,</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">230deg</span> <span class="m">80%</span> <span class="m">35%</span> <span class="o">/</span> <span class="m">0.45</span><span class="p">),</span> <span class="nb">transparent</span> <span class="m">32%</span><span class="p">),</span>
    <span class="nf">radial-gradient</span><span class="p">(</span><span class="nb">circle</span> <span class="n">at</span> <span class="m">80%</span> <span class="m">10%</span><span class="p">,</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">280deg</span> <span class="m">70%</span> <span class="m">38%</span> <span class="o">/</span> <span class="m">0.35</span><span class="p">),</span> <span class="nb">transparent</span> <span class="m">30%</span><span class="p">),</span>
    <span class="nf">linear-gradient</span><span class="p">(</span><span class="m">135deg</span><span class="p">,</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">230deg</span> <span class="m">50%</span> <span class="m">12%</span><span class="p">),</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">250deg</span> <span class="m">52%</span> <span class="m">18%</span><span class="p">));</span>
  <span class="nl">box-shadow</span><span class="p">:</span> <span class="m">0</span> <span class="m">1rem</span> <span class="m">2.5rem</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">230deg</span> <span class="m">40%</span> <span class="m">12%</span> <span class="o">/</span> <span class="m">0.22</span><span class="p">);</span>
<span class="p">}</span>

<span class="nc">.innerFrame</span> <span class="p">{</span>
  <span class="nl">position</span><span class="p">:</span> <span class="nb">absolute</span><span class="p">;</span>
  <span class="nl">inset</span><span class="p">:</span> <span class="nf">calc</span><span class="p">(</span><span class="nf">var</span><span class="p">(</span><span class="l">--star-size</span><span class="p">)</span> <span class="o">/</span> <span class="m">2</span><span class="p">);</span>
  <span class="nl">border</span><span class="p">:</span> <span class="m">1px</span> <span class="nb">dashed</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">48deg</span> <span class="m">100%</span> <span class="m">80%</span> <span class="o">/</span> <span class="m">0.5</span><span class="p">);</span>
  <span class="nl">border-radius</span><span class="p">:</span> <span class="m">0.8rem</span><span class="p">;</span>
<span class="p">}</span>

<span class="nc">.star</span> <span class="p">{</span>
  <span class="nl">position</span><span class="p">:</span> <span class="nb">absolute</span><span class="p">;</span>
  <span class="nl">top</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--top</span><span class="p">);</span>
  <span class="nl">left</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--left</span><span class="p">);</span>
  <span class="nl">display</span><span class="p">:</span> <span class="nb">grid</span><span class="p">;</span>
  <span class="nl">place-items</span><span class="p">:</span> <span class="nb">center</span><span class="p">;</span>
  <span class="nl">width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--star-size</span><span class="p">);</span>
  <span class="nl">height</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--star-size</span><span class="p">);</span>
  <span class="nl">color</span><span class="p">:</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">48deg</span> <span class="m">100%</span> <span class="m">64%</span><span class="p">);</span>
  <span class="nl">font-size</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--star-size</span><span class="p">);</span>
  <span class="nl">line-height</span><span class="p">:</span> <span class="m">1</span><span class="p">;</span>
  <span class="nl">pointer-events</span><span class="p">:</span> <span class="nb">none</span><span class="p">;</span>
  <span class="nl">text-shadow</span><span class="p">:</span> <span class="m">0</span> <span class="m">0</span> <span class="m">0.8rem</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">48deg</span> <span class="m">100%</span> <span class="m">70%</span> <span class="o">/</span> <span class="m">0.8</span><span class="p">);</span>
  <span class="nl">transform</span><span class="p">:</span> <span class="nf">translate</span><span class="p">(</span><span class="m">-50%</span><span class="p">,</span> <span class="m">-50%</span><span class="p">)</span> <span class="nf">scale</span><span class="p">(</span><span class="m">0.6</span><span class="p">);</span>
  <span class="nl">animation</span><span class="p">:</span> <span class="n">star-pop</span> <span class="m">180ms</span> <span class="nb">ease-out</span> <span class="nb">forwards</span><span class="p">;</span>
<span class="p">}</span>

<span class="nc">.addStarButton</span> <span class="p">{</span>
  <span class="nl">border</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="nl">border-radius</span><span class="p">:</span> <span class="m">999px</span><span class="p">;</span>
  <span class="nl">padding</span><span class="p">:</span> <span class="m">0.75rem</span> <span class="m">1.1rem</span><span class="p">;</span>
  <span class="nl">background</span><span class="p">:</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">48deg</span> <span class="m">100%</span> <span class="m">58%</span><span class="p">);</span>
  <span class="nl">color</span><span class="p">:</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">230deg</span> <span class="m">40%</span> <span class="m">14%</span><span class="p">);</span>
  <span class="nl">cursor</span><span class="p">:</span> <span class="nb">pointer</span><span class="p">;</span>
  <span class="nl">font-weight</span><span class="p">:</span> <span class="m">800</span><span class="p">;</span>
  <span class="nl">box-shadow</span><span class="p">:</span> <span class="m">0</span> <span class="m">0.55rem</span> <span class="m">1.2rem</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">48deg</span> <span class="m">100%</span> <span class="m">40%</span> <span class="o">/</span> <span class="m">0.25</span><span class="p">);</span>
<span class="p">}</span>

<span class="nc">.addStarButton</span><span class="nd">:focus-visible</span> <span class="p">{</span>
  <span class="nl">outline</span><span class="p">:</span> <span class="m">3px</span> <span class="nb">solid</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">48deg</span> <span class="m">100%</span> <span class="m">78%</span> <span class="o">/</span> <span class="m">0.8</span><span class="p">);</span>
  <span class="nl">outline-offset</span><span class="p">:</span> <span class="m">4px</span><span class="p">;</span>
<span class="p">}</span>

<span class="k">@keyframes</span> <span class="n">star-pop</span> <span class="p">{</span>
  <span class="nt">to</span> <span class="p">{</span>
    <span class="nl">transform</span><span class="p">:</span> <span class="nf">translate</span><span class="p">(</span><span class="m">-50%</span><span class="p">,</span> <span class="m">-50%</span><span class="p">)</span> <span class="nf">scale</span><span class="p">(</span><span class="m">1</span><span class="p">);</span>
  <span class="p">}</span>
<span class="p">}</span></code></pre></figure>
</div>
      </div>
    

    
      <div class="code-playground__panel" role="tabpanel" data-playground-panel="js" hidden="">
        <div class="code-playground__source">
<figure class="highlight"><pre><code class="language-javascript" data-lang="javascript"><span class="kd">const</span> <span class="nx">stage</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nf">querySelector</span><span class="p">(</span><span class="dl">"</span><span class="s2">[data-star-stage]</span><span class="dl">"</span><span class="p">);</span>
<span class="kd">const</span> <span class="nx">button</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nf">querySelector</span><span class="p">(</span><span class="dl">"</span><span class="s2">[data-add-star]</span><span class="dl">"</span><span class="p">);</span>

<span class="kd">function</span> <span class="nf">randomPercent</span><span class="p">()</span> <span class="p">{</span>
  <span class="k">return</span> <span class="nb">Math</span><span class="p">.</span><span class="nf">round</span><span class="p">(</span><span class="nb">Math</span><span class="p">.</span><span class="nf">random</span><span class="p">()</span> <span class="o">*</span> <span class="mi">10000</span><span class="p">)</span> <span class="o">/</span> <span class="mi">100</span><span class="p">;</span>
<span class="p">}</span>

<span class="kd">function</span> <span class="nf">addStar</span><span class="p">()</span> <span class="p">{</span>
  <span class="kd">const</span> <span class="nx">star</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nf">createElement</span><span class="p">(</span><span class="dl">"</span><span class="s2">span</span><span class="dl">"</span><span class="p">);</span>

  <span class="nx">star</span><span class="p">.</span><span class="nx">className</span> <span class="o">=</span> <span class="dl">"</span><span class="s2">star</span><span class="dl">"</span><span class="p">;</span>
  <span class="nx">star</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nf">setProperty</span><span class="p">(</span><span class="dl">"</span><span class="s2">--top</span><span class="dl">"</span><span class="p">,</span> <span class="nf">randomPercent</span><span class="p">()</span> <span class="o">+</span> <span class="dl">"</span><span class="s2">%</span><span class="dl">"</span><span class="p">);</span>
  <span class="nx">star</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nf">setProperty</span><span class="p">(</span><span class="dl">"</span><span class="s2">--left</span><span class="dl">"</span><span class="p">,</span> <span class="nf">randomPercent</span><span class="p">()</span> <span class="o">+</span> <span class="dl">"</span><span class="s2">%</span><span class="dl">"</span><span class="p">);</span>
  <span class="nx">star</span><span class="p">.</span><span class="nx">innerHTML</span> <span class="o">=</span> <span class="dl">"</span><span class="s2">&amp;#9733;</span><span class="dl">"</span><span class="p">;</span>

  <span class="nx">stage</span><span class="p">.</span><span class="nf">appendChild</span><span class="p">(</span><span class="nx">star</span><span class="p">);</span>
<span class="p">}</span>

<span class="nx">button</span><span class="p">.</span><span class="nf">addEventListener</span><span class="p">(</span><span class="dl">"</span><span class="s2">click</span><span class="dl">"</span><span class="p">,</span> <span class="nx">addStar</span><span class="p">);</span></code></pre></figure>
</div>
      </div>
    
  </div>
</section>

<h2 id="the-problem">The Problem</h2>

<p><code class="language-plaintext highlighter-rouge">top</code> and <code class="language-plaintext highlighter-rouge">left</code> do not place the whole object. They place one point on the object.</p>

<p>By default, that point is the object’s top-left corner:</p>

<div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nc">.star</span> <span class="p">{</span>
  <span class="nl">position</span><span class="p">:</span> <span class="nb">absolute</span><span class="p">;</span>
  <span class="nl">top</span><span class="p">:</span> <span class="m">100%</span><span class="p">;</span>
  <span class="nl">left</span><span class="p">:</span> <span class="m">100%</span><span class="p">;</span>
<span class="p">}</span>
</code></pre></div></div>

<p>At <code class="language-plaintext highlighter-rouge">left: 100%</code>, the top-left corner reaches the right edge. The rest of the star keeps going, so it spills outside the frame.</p>

<h2 id="move-the-anchor">Move The Anchor</h2>

<p>The first fix is to move the object’s anchor from its top-left corner to its center:</p>

<div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nc">.star</span> <span class="p">{</span>
  <span class="nl">transform</span><span class="p">:</span> <span class="nf">translate</span><span class="p">(</span><span class="m">-50%</span><span class="p">,</span> <span class="m">-50%</span><span class="p">);</span>
<span class="p">}</span>
</code></pre></div></div>

<p>The useful detail is that percentages in <code class="language-plaintext highlighter-rouge">transform</code> are based on the object itself. <code class="language-plaintext highlighter-rouge">translate(-50%, -50%)</code> moves the star left by half of its own width and up by half of its own height.</p>

<p>Now <code class="language-plaintext highlighter-rouge">top</code> and <code class="language-plaintext highlighter-rouge">left</code> describe the star’s center point.</p>

<h2 id="add-the-inner-frame">Add The Inner Frame</h2>

<p>Center positioning is balanced, but it still allows half the star to overflow when the center touches an edge.</p>

<p>That is why the demo has two frames:</p>

<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"starFrame"</span><span class="nt">&gt;</span>
  <span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"innerFrame"</span><span class="nt">&gt;&lt;/div&gt;</span>
<span class="nt">&lt;/div&gt;</span>
</code></pre></div></div>

<p>The inner frame is inset by half the star size:</p>

<div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nc">.starFrame</span> <span class="p">{</span>
  <span class="py">--star-size</span><span class="p">:</span> <span class="m">2rem</span><span class="p">;</span>
<span class="p">}</span>

<span class="nc">.innerFrame</span> <span class="p">{</span>
  <span class="nl">position</span><span class="p">:</span> <span class="nb">absolute</span><span class="p">;</span>
  <span class="nl">inset</span><span class="p">:</span> <span class="nf">calc</span><span class="p">(</span><span class="nf">var</span><span class="p">(</span><span class="l">--star-size</span><span class="p">)</span> <span class="o">/</span> <span class="m">2</span><span class="p">);</span>
<span class="p">}</span>
</code></pre></div></div>

<p>The star is still allowed to sit on the inner frame’s edges. Since the inner frame is pulled away from the outer frame by half a star, the full star remains visible.</p>

<h2 id="the-click-handler">The Click Handler</h2>

<p>The JavaScript only creates a star and gives it two random percentages:</p>

<div class="language-js highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">function</span> <span class="nf">addStar</span><span class="p">()</span> <span class="p">{</span>
  <span class="kd">const</span> <span class="nx">star</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nf">createElement</span><span class="p">(</span><span class="dl">"</span><span class="s2">span</span><span class="dl">"</span><span class="p">);</span>

  <span class="nx">star</span><span class="p">.</span><span class="nx">className</span> <span class="o">=</span> <span class="dl">"</span><span class="s2">star</span><span class="dl">"</span><span class="p">;</span>
  <span class="nx">star</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nf">setProperty</span><span class="p">(</span><span class="dl">"</span><span class="s2">--top</span><span class="dl">"</span><span class="p">,</span> <span class="nf">randomPercent</span><span class="p">()</span> <span class="o">+</span> <span class="dl">"</span><span class="s2">%</span><span class="dl">"</span><span class="p">);</span>
  <span class="nx">star</span><span class="p">.</span><span class="nx">style</span><span class="p">.</span><span class="nf">setProperty</span><span class="p">(</span><span class="dl">"</span><span class="s2">--left</span><span class="dl">"</span><span class="p">,</span> <span class="nf">randomPercent</span><span class="p">()</span> <span class="o">+</span> <span class="dl">"</span><span class="s2">%</span><span class="dl">"</span><span class="p">);</span>
  <span class="nx">star</span><span class="p">.</span><span class="nx">innerHTML</span> <span class="o">=</span> <span class="dl">"</span><span class="s2">&amp;#9733;</span><span class="dl">"</span><span class="p">;</span>

  <span class="nx">stage</span><span class="p">.</span><span class="nf">appendChild</span><span class="p">(</span><span class="nx">star</span><span class="p">);</span>
<span class="p">}</span>
</code></pre></div></div>

<p>The containment does not live in JavaScript. JavaScript picks a position. CSS decides what that position means.</p>]]></content><author><name></name></author><category term="code" /><summary type="html"><![CDATA[A small HTML, CSS, and JavaScript demo that shows how to place objects inside a frame without letting them spill outside the edges.]]></summary></entry><entry><title type="html">Create a Shimmer Button</title><link href="https://goodbran.com/2026/05/05/create-a-shimmer-button/" rel="alternate" type="text/html" title="Create a Shimmer Button" /><published>2026-05-05T16:00:00+00:00</published><updated>2026-05-05T16:00:00+00:00</updated><id>https://goodbran.com/2026/05/05/create-a-shimmer-button</id><content type="html" xml:base="https://goodbran.com/2026/05/05/create-a-shimmer-button/"><![CDATA[<p>A shimmer button is just a light sweep across a clipped button. The trick is not the gradient. The trick is knowing when to create it, when to ignore extra triggers, and when to clean it up.</p>

<p>We should create the shimmer only when the button is hovered or focused, let one shimmer finish before starting another, and remove the shimmer element when the animation is done.</p>

<h2 id="the-result">The Result</h2>

<p>Hover the button, or tab to it with the keyboard.</p>

<section class="code-playground" data-code-playground="" style="--playground-height: 320px;">
  <div class="code-playground__header">
    <h3 class="code-playground__title">Shimmer Button</h3>
    <div class="code-playground__tabs" role="tablist" aria-label="Switch code playground view">
      <button class="code-playground__tab is-active" type="button" role="tab" aria-selected="true" data-playground-tab="preview">Preview</button>
      <button class="code-playground__tab" type="button" role="tab" aria-selected="false" data-playground-tab="html">HTML</button>
      
        <button class="code-playground__tab" type="button" role="tab" aria-selected="false" data-playground-tab="css">CSS</button>
      
      
        <button class="code-playground__tab" type="button" role="tab" aria-selected="false" data-playground-tab="js">JS</button>
      
    </div>
  </div>

  <div class="code-playground__body">
    <div class="code-playground__panel is-active" role="tabpanel" data-playground-panel="preview">
      <iframe class="code-playground__preview" title="Shimmer Button preview" sandbox="allow-scripts" loading="lazy" srcdoc="&lt;!doctype html&gt;
&lt;html lang=&quot;en&quot;&gt;
&lt;head&gt;
  &lt;meta charset=&quot;utf-8&quot;&gt;
  &lt;meta name=&quot;viewport&quot; content=&quot;width=device-width, initial-scale=1&quot;&gt;
  &lt;style&gt;
    *,
    *::before,
    *::after {
      box-sizing: border-box;
    }

    *:not(dialog) {
      margin: 0;
    }

    @media (prefers-reduced-motion: no-preference) {
      html {
        interpolate-size: allow-keywords;
      }
    }

    body {
      display: grid;
      place-items: center;
      min-height: 100vh;
      padding: 1rem;
      color: #15141a;
      background: #ffffff;
      font-family: Inter, -apple-system, BlinkMacSystemFont, &quot;Segoe UI&quot;, sans-serif;
      line-height: 1.5;
      -webkit-font-smoothing: antialiased;
    }

    img,
    picture,
    video,
    canvas,
    svg {
      display: block;
      max-width: 100%;
    }

    input,
    button,
    textarea,
    select {
      font: inherit;
    }

    p,
    h1,
    h2,
    h3,
    h4,
    h5,
    h6 {
      overflow-wrap: break-word;
    }

    p {
      text-wrap: pretty;
    }

    h1,
    h2,
    h3,
    h4,
    h5,
    h6 {
      text-wrap: balance;
    }

    #root,
    #__next {
      isolation: isolate;
    }


.buyButton {
  position: relative;
  display: block;
  overflow: hidden;
  padding: 1rem 3rem;
  border: 0;
  border-radius: 1000px;
  background:
    radial-gradient(
      circle at 50% 0%,
      oklch(0.5 0.15 165 / 0) 0% 60%,
      oklch(0.5 0.15 165 / 0.125) 70%,
      oklch(0.5 0.15 165 / 0.325) 80%,
      oklch(0.5 0.15 165 / 0) 100%
    ),
    linear-gradient(
      to top,
      oklch(0.6 0.19 164),
      oklch(0.9 0.2 182)
    );
  box-shadow:
    inset 0 -1px 2px hsl(175deg 100% 20% / 0.5),
    inset 0 -3px 6px hsl(175deg 100% 20% / 0.4),
    inset 0 5px 5px hsl(175deg 100% 90% / 0.75),
    0 16px 30px hsl(175deg 100% 20% / 0.22);
  color: hsl(175deg 100% 12%);
  cursor: pointer;
  font-weight: 700;
}

.buyButton:focus-visible {
  outline: 3px solid hsl(180deg 100% 80% / 0.75);
  outline-offset: 4px;
}

.shimmer {
  position: absolute;
  inset: 0;
  background: linear-gradient(
    to right,
    transparent,
    hsl(180deg 100% 90% / 0.85),
    transparent
  );
  pointer-events: none;
  transform: translateX(-100%);
  animation: shimmer-sweep 800ms ease-out forwards;
}

@keyframes shimmer-sweep {
  to {
    transform: translateX(100%);
  }
}

@media (prefers-reduced-motion: reduce) {
  .shimmer {
    display: none;
  }
}

  &lt;/style&gt;
&lt;/head&gt;
&lt;body&gt;

&lt;button class=&quot;buyButton&quot; type=&quot;button&quot; data-shimmer-button&gt;Buy Now&lt;/button&gt;


  &lt;script&gt;

const btn = document.querySelector(&quot;[data-shimmer-button]&quot;);

function clearShimmer(shimmer) {
  shimmer.remove();
  delete btn.dataset.shimmering;
}

function generateShimmer() {
  if (btn.dataset.shimmering === &quot;true&quot;) {
    return;
  }

  if (window.matchMedia(&quot;(prefers-reduced-motion: reduce)&quot;).matches) {
    return;
  }

  const shimmer = document.createElement(&quot;span&quot;);
  shimmer.classList.add(&quot;shimmer&quot;);

  btn.dataset.shimmering = &quot;true&quot;;
  btn.appendChild(shimmer);

  shimmer.addEventListener(&quot;animationend&quot;, () =&gt; {
    clearShimmer(shimmer);
  }, { once: true });
}

btn.addEventListener(&quot;mouseenter&quot;, generateShimmer);
btn.addEventListener(&quot;focus&quot;, generateShimmer);

  &lt;/script&gt;

&lt;/body&gt;
&lt;/html&gt;"></iframe>
    </div>

    <div class="code-playground__panel" role="tabpanel" data-playground-panel="html" hidden="">
      <div class="code-playground__source">
<figure class="highlight"><pre><code class="language-html" data-lang="html"><span class="nt">&lt;button</span> <span class="na">class=</span><span class="s">"buyButton"</span> <span class="na">type=</span><span class="s">"button"</span> <span class="na">data-shimmer-button</span><span class="nt">&gt;</span>Buy Now<span class="nt">&lt;/button&gt;</span></code></pre></figure>
</div>
    </div>

    
      <div class="code-playground__panel" role="tabpanel" data-playground-panel="css" hidden="">
        <div class="code-playground__source">
<figure class="highlight"><pre><code class="language-css" data-lang="css"><span class="nc">.buyButton</span> <span class="p">{</span>
  <span class="nl">position</span><span class="p">:</span> <span class="nb">relative</span><span class="p">;</span>
  <span class="nl">display</span><span class="p">:</span> <span class="nb">block</span><span class="p">;</span>
  <span class="nl">overflow</span><span class="p">:</span> <span class="nb">hidden</span><span class="p">;</span>
  <span class="nl">padding</span><span class="p">:</span> <span class="m">1rem</span> <span class="m">3rem</span><span class="p">;</span>
  <span class="nl">border</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="nl">border-radius</span><span class="p">:</span> <span class="m">1000px</span><span class="p">;</span>
  <span class="nl">background</span><span class="p">:</span>
    <span class="nf">radial-gradient</span><span class="p">(</span>
      <span class="nb">circle</span> <span class="n">at</span> <span class="m">50%</span> <span class="m">0%</span><span class="p">,</span>
      <span class="nf">oklch</span><span class="p">(</span><span class="m">0.5</span> <span class="m">0.15</span> <span class="m">165</span> <span class="o">/</span> <span class="m">0</span><span class="p">)</span> <span class="m">0%</span> <span class="m">60%</span><span class="p">,</span>
      <span class="nf">oklch</span><span class="p">(</span><span class="m">0.5</span> <span class="m">0.15</span> <span class="m">165</span> <span class="o">/</span> <span class="m">0.125</span><span class="p">)</span> <span class="m">70%</span><span class="p">,</span>
      <span class="nf">oklch</span><span class="p">(</span><span class="m">0.5</span> <span class="m">0.15</span> <span class="m">165</span> <span class="o">/</span> <span class="m">0.325</span><span class="p">)</span> <span class="m">80%</span><span class="p">,</span>
      <span class="nf">oklch</span><span class="p">(</span><span class="m">0.5</span> <span class="m">0.15</span> <span class="m">165</span> <span class="o">/</span> <span class="m">0</span><span class="p">)</span> <span class="m">100%</span>
    <span class="p">),</span>
    <span class="nf">linear-gradient</span><span class="p">(</span>
      <span class="n">to</span> <span class="nb">top</span><span class="p">,</span>
      <span class="nf">oklch</span><span class="p">(</span><span class="m">0.6</span> <span class="m">0.19</span> <span class="m">164</span><span class="p">),</span>
      <span class="nf">oklch</span><span class="p">(</span><span class="m">0.9</span> <span class="m">0.2</span> <span class="m">182</span><span class="p">)</span>
    <span class="p">);</span>
  <span class="nl">box-shadow</span><span class="p">:</span>
    <span class="nb">inset</span> <span class="m">0</span> <span class="m">-1px</span> <span class="m">2px</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">175deg</span> <span class="m">100%</span> <span class="m">20%</span> <span class="o">/</span> <span class="m">0.5</span><span class="p">),</span>
    <span class="nb">inset</span> <span class="m">0</span> <span class="m">-3px</span> <span class="m">6px</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">175deg</span> <span class="m">100%</span> <span class="m">20%</span> <span class="o">/</span> <span class="m">0.4</span><span class="p">),</span>
    <span class="nb">inset</span> <span class="m">0</span> <span class="m">5px</span> <span class="m">5px</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">175deg</span> <span class="m">100%</span> <span class="m">90%</span> <span class="o">/</span> <span class="m">0.75</span><span class="p">),</span>
    <span class="m">0</span> <span class="m">16px</span> <span class="m">30px</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">175deg</span> <span class="m">100%</span> <span class="m">20%</span> <span class="o">/</span> <span class="m">0.22</span><span class="p">);</span>
  <span class="nl">color</span><span class="p">:</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">175deg</span> <span class="m">100%</span> <span class="m">12%</span><span class="p">);</span>
  <span class="nl">cursor</span><span class="p">:</span> <span class="nb">pointer</span><span class="p">;</span>
  <span class="nl">font-weight</span><span class="p">:</span> <span class="m">700</span><span class="p">;</span>
<span class="p">}</span>

<span class="nc">.buyButton</span><span class="nd">:focus-visible</span> <span class="p">{</span>
  <span class="nl">outline</span><span class="p">:</span> <span class="m">3px</span> <span class="nb">solid</span> <span class="nf">hsl</span><span class="p">(</span><span class="m">180deg</span> <span class="m">100%</span> <span class="m">80%</span> <span class="o">/</span> <span class="m">0.75</span><span class="p">);</span>
  <span class="nl">outline-offset</span><span class="p">:</span> <span class="m">4px</span><span class="p">;</span>
<span class="p">}</span>

<span class="nc">.shimmer</span> <span class="p">{</span>
  <span class="nl">position</span><span class="p">:</span> <span class="nb">absolute</span><span class="p">;</span>
  <span class="nl">inset</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="nl">background</span><span class="p">:</span> <span class="nf">linear-gradient</span><span class="p">(</span>
    <span class="n">to</span> <span class="nb">right</span><span class="p">,</span>
    <span class="nb">transparent</span><span class="p">,</span>
    <span class="nf">hsl</span><span class="p">(</span><span class="m">180deg</span> <span class="m">100%</span> <span class="m">90%</span> <span class="o">/</span> <span class="m">0.85</span><span class="p">),</span>
    <span class="nb">transparent</span>
  <span class="p">);</span>
  <span class="nl">pointer-events</span><span class="p">:</span> <span class="nb">none</span><span class="p">;</span>
  <span class="nl">transform</span><span class="p">:</span> <span class="nf">translateX</span><span class="p">(</span><span class="m">-100%</span><span class="p">);</span>
  <span class="nl">animation</span><span class="p">:</span> <span class="n">shimmer-sweep</span> <span class="m">800ms</span> <span class="nb">ease-out</span> <span class="nb">forwards</span><span class="p">;</span>
<span class="p">}</span>

<span class="k">@keyframes</span> <span class="n">shimmer-sweep</span> <span class="p">{</span>
  <span class="nt">to</span> <span class="p">{</span>
    <span class="nl">transform</span><span class="p">:</span> <span class="nf">translateX</span><span class="p">(</span><span class="m">100%</span><span class="p">);</span>
  <span class="p">}</span>
<span class="p">}</span>

<span class="k">@media</span> <span class="p">(</span><span class="n">prefers-reduced-motion</span><span class="p">:</span> <span class="n">reduce</span><span class="p">)</span> <span class="p">{</span>
  <span class="nc">.shimmer</span> <span class="p">{</span>
    <span class="nl">display</span><span class="p">:</span> <span class="nb">none</span><span class="p">;</span>
  <span class="p">}</span>
<span class="p">}</span></code></pre></figure>
</div>
      </div>
    

    
      <div class="code-playground__panel" role="tabpanel" data-playground-panel="js" hidden="">
        <div class="code-playground__source">
<figure class="highlight"><pre><code class="language-javascript" data-lang="javascript"><span class="kd">const</span> <span class="nx">btn</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nf">querySelector</span><span class="p">(</span><span class="dl">"</span><span class="s2">[data-shimmer-button]</span><span class="dl">"</span><span class="p">);</span>

<span class="kd">function</span> <span class="nf">clearShimmer</span><span class="p">(</span><span class="nx">shimmer</span><span class="p">)</span> <span class="p">{</span>
  <span class="nx">shimmer</span><span class="p">.</span><span class="nf">remove</span><span class="p">();</span>
  <span class="k">delete</span> <span class="nx">btn</span><span class="p">.</span><span class="nx">dataset</span><span class="p">.</span><span class="nx">shimmering</span><span class="p">;</span>
<span class="p">}</span>

<span class="kd">function</span> <span class="nf">generateShimmer</span><span class="p">()</span> <span class="p">{</span>
  <span class="k">if </span><span class="p">(</span><span class="nx">btn</span><span class="p">.</span><span class="nx">dataset</span><span class="p">.</span><span class="nx">shimmering</span> <span class="o">===</span> <span class="dl">"</span><span class="s2">true</span><span class="dl">"</span><span class="p">)</span> <span class="p">{</span>
    <span class="k">return</span><span class="p">;</span>
  <span class="p">}</span>

  <span class="k">if </span><span class="p">(</span><span class="nb">window</span><span class="p">.</span><span class="nf">matchMedia</span><span class="p">(</span><span class="dl">"</span><span class="s2">(prefers-reduced-motion: reduce)</span><span class="dl">"</span><span class="p">).</span><span class="nx">matches</span><span class="p">)</span> <span class="p">{</span>
    <span class="k">return</span><span class="p">;</span>
  <span class="p">}</span>

  <span class="kd">const</span> <span class="nx">shimmer</span> <span class="o">=</span> <span class="nb">document</span><span class="p">.</span><span class="nf">createElement</span><span class="p">(</span><span class="dl">"</span><span class="s2">span</span><span class="dl">"</span><span class="p">);</span>
  <span class="nx">shimmer</span><span class="p">.</span><span class="nx">classList</span><span class="p">.</span><span class="nf">add</span><span class="p">(</span><span class="dl">"</span><span class="s2">shimmer</span><span class="dl">"</span><span class="p">);</span>

  <span class="nx">btn</span><span class="p">.</span><span class="nx">dataset</span><span class="p">.</span><span class="nx">shimmering</span> <span class="o">=</span> <span class="dl">"</span><span class="s2">true</span><span class="dl">"</span><span class="p">;</span>
  <span class="nx">btn</span><span class="p">.</span><span class="nf">appendChild</span><span class="p">(</span><span class="nx">shimmer</span><span class="p">);</span>

  <span class="nx">shimmer</span><span class="p">.</span><span class="nf">addEventListener</span><span class="p">(</span><span class="dl">"</span><span class="s2">animationend</span><span class="dl">"</span><span class="p">,</span> <span class="p">()</span> <span class="o">=&gt;</span> <span class="p">{</span>
    <span class="nf">clearShimmer</span><span class="p">(</span><span class="nx">shimmer</span><span class="p">);</span>
  <span class="p">},</span> <span class="p">{</span> <span class="na">once</span><span class="p">:</span> <span class="kc">true</span> <span class="p">});</span>
<span class="p">}</span>

<span class="nx">btn</span><span class="p">.</span><span class="nf">addEventListener</span><span class="p">(</span><span class="dl">"</span><span class="s2">mouseenter</span><span class="dl">"</span><span class="p">,</span> <span class="nx">generateShimmer</span><span class="p">);</span>
<span class="nx">btn</span><span class="p">.</span><span class="nf">addEventListener</span><span class="p">(</span><span class="dl">"</span><span class="s2">focus</span><span class="dl">"</span><span class="p">,</span> <span class="nx">generateShimmer</span><span class="p">);</span></code></pre></figure>
</div>
      </div>
    
  </div>
</section>

<h2 id="what-we-need">What We Need</h2>

<p>The button needs four pieces:</p>

<ol>
  <li>A real <code class="language-plaintext highlighter-rouge">&lt;button&gt;</code> so clicks, focus, and keyboard behavior work without extra code.</li>
  <li><code class="language-plaintext highlighter-rouge">position: relative</code> and <code class="language-plaintext highlighter-rouge">overflow: hidden</code> so the shimmer can move inside the pill shape.</li>
  <li>A generated <code class="language-plaintext highlighter-rouge">.shimmer</code> element that runs one animation and then disappears.</li>
  <li>A small JavaScript guard so repeated hover or focus events do not pile up extra shimmer elements.</li>
</ol>

<p>The markup stays boring on purpose:</p>

<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;button</span> <span class="na">class=</span><span class="s">"buyButton"</span> <span class="na">type=</span><span class="s">"button"</span> <span class="na">data-shimmer-button</span><span class="nt">&gt;</span>Buy Now<span class="nt">&lt;/button&gt;</span>
</code></pre></div></div>

<h2 id="the-button-shell">The Button Shell</h2>

<p>Start with the button itself. The important properties are not the colors. They are the layout rules that let the effect work.</p>

<div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nc">.buyButton</span> <span class="p">{</span>
  <span class="nl">position</span><span class="p">:</span> <span class="nb">relative</span><span class="p">;</span>
  <span class="nl">overflow</span><span class="p">:</span> <span class="nb">hidden</span><span class="p">;</span>
  <span class="nl">border-radius</span><span class="p">:</span> <span class="m">1000px</span><span class="p">;</span>
<span class="p">}</span>
</code></pre></div></div>

<p><code class="language-plaintext highlighter-rouge">position: relative</code> gives the shimmer a positioning context. <code class="language-plaintext highlighter-rouge">overflow: hidden</code> clips the shimmer to the rounded button.</p>

<h2 id="the-shimmer-layer">The Shimmer Layer</h2>

<p>The shimmer is a temporary span. It covers the button, starts outside the left edge, and slides across.</p>

<div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nc">.shimmer</span> <span class="p">{</span>
  <span class="nl">position</span><span class="p">:</span> <span class="nb">absolute</span><span class="p">;</span>
  <span class="nl">inset</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="nl">pointer-events</span><span class="p">:</span> <span class="nb">none</span><span class="p">;</span>
  <span class="nl">transform</span><span class="p">:</span> <span class="nf">translateX</span><span class="p">(</span><span class="m">-100%</span><span class="p">);</span>
  <span class="nl">animation</span><span class="p">:</span> <span class="n">shimmer-sweep</span> <span class="m">800ms</span> <span class="nb">ease-out</span> <span class="nb">forwards</span><span class="p">;</span>
<span class="p">}</span>

<span class="k">@keyframes</span> <span class="n">shimmer-sweep</span> <span class="p">{</span>
  <span class="nt">to</span> <span class="p">{</span>
    <span class="nl">transform</span><span class="p">:</span> <span class="nf">translateX</span><span class="p">(</span><span class="m">100%</span><span class="p">);</span>
  <span class="p">}</span>
<span class="p">}</span>
</code></pre></div></div>

<p><code class="language-plaintext highlighter-rouge">pointer-events: none</code> matters. The shimmer should never steal hover, focus, or click behavior from the button.</p>

<h2 id="the-javascript-guard">The JavaScript Guard</h2>

<p>The simple version appends a new shimmer on every <code class="language-plaintext highlighter-rouge">mouseenter</code>. That works once, then gets messy if the pointer moves in and out quickly.</p>

<p>Instead, mark the button while the shimmer is running:</p>

<div class="language-js highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="k">if </span><span class="p">(</span><span class="nx">btn</span><span class="p">.</span><span class="nx">dataset</span><span class="p">.</span><span class="nx">shimmering</span> <span class="o">===</span> <span class="dl">"</span><span class="s2">true</span><span class="dl">"</span><span class="p">)</span> <span class="p">{</span>
  <span class="k">return</span><span class="p">;</span>
<span class="p">}</span>

<span class="nx">btn</span><span class="p">.</span><span class="nx">dataset</span><span class="p">.</span><span class="nx">shimmering</span> <span class="o">=</span> <span class="dl">"</span><span class="s2">true</span><span class="dl">"</span><span class="p">;</span>
</code></pre></div></div>

<p>Then clean up after the animation:</p>

<div class="language-js highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nx">shimmer</span><span class="p">.</span><span class="nf">addEventListener</span><span class="p">(</span><span class="dl">"</span><span class="s2">animationend</span><span class="dl">"</span><span class="p">,</span> <span class="p">()</span> <span class="o">=&gt;</span> <span class="p">{</span>
  <span class="nx">shimmer</span><span class="p">.</span><span class="nf">remove</span><span class="p">();</span>
  <span class="k">delete</span> <span class="nx">btn</span><span class="p">.</span><span class="nx">dataset</span><span class="p">.</span><span class="nx">shimmering</span><span class="p">;</span>
<span class="p">},</span> <span class="p">{</span> <span class="na">once</span><span class="p">:</span> <span class="kc">true</span> <span class="p">});</span>
</code></pre></div></div>

<h2 id="hover-and-focus">Hover And Focus</h2>

<p>Hover is not enough. Keyboard users should get the same effect when the button receives focus.</p>

<div class="language-js highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nx">btn</span><span class="p">.</span><span class="nf">addEventListener</span><span class="p">(</span><span class="dl">"</span><span class="s2">mouseenter</span><span class="dl">"</span><span class="p">,</span> <span class="nx">generateShimmer</span><span class="p">);</span>
<span class="nx">btn</span><span class="p">.</span><span class="nf">addEventListener</span><span class="p">(</span><span class="dl">"</span><span class="s2">focus</span><span class="dl">"</span><span class="p">,</span> <span class="nx">generateShimmer</span><span class="p">);</span>
</code></pre></div></div>

<p>That is the whole pattern: create the effect on demand, let one run at a time, and remove it when it is done.</p>]]></content><author><name></name></author><category term="code" /><summary type="html"><![CDATA[A small HTML, CSS, and JavaScript pattern for creating a shimmer button that does not stack duplicate effects or leave extra elements behind.]]></summary></entry><entry><title type="html">Code Previews Belong in the Post</title><link href="https://goodbran.com/2026/05/05/code-previews-belong-in-the-post/" rel="alternate" type="text/html" title="Code Previews Belong in the Post" /><published>2026-05-05T02:00:00+00:00</published><updated>2026-05-05T02:00:00+00:00</updated><id>https://goodbran.com/2026/05/05/code-previews-belong-in-the-post</id><content type="html" xml:base="https://goodbran.com/2026/05/05/code-previews-belong-in-the-post/"><![CDATA[<p>A post about code should show the code running. Not as a SaaS embed. Not as a dependency carnival. Right here, in the page.</p>

<p>So this blog now has a tiny static playground: Preview, HTML, CSS, JS. Boring pieces. Great result.</p>

<h2 id="the-core-idea">The Core Idea</h2>

<p>Treat the demo as content.</p>

<p>The post captures three strings: <code class="language-plaintext highlighter-rouge">html</code>, <code class="language-plaintext highlighter-rouge">css</code>, and <code class="language-plaintext highlighter-rouge">js</code>. The include renders the source tabs with Rouge highlighting, then renders the live preview inside a sandboxed <code class="language-plaintext highlighter-rouge">iframe</code> using <code class="language-plaintext highlighter-rouge">srcdoc</code>.</p>

<p>No server. No client-side compiler. No framework ceremony. Just HTML doing HTML things.</p>

<h2 id="the-shape">The Shape</h2>

<div class="language-liquid highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cp">{%</span><span class="w"> </span><span class="nt">capture</span><span class="w"> </span><span class="nv">demo_html</span><span class="w"> </span><span class="cp">%}</span>
&lt;button class="hello-button" data-answer&gt;Click me&lt;/button&gt;
<span class="cp">{%</span><span class="w"> </span><span class="nt">endcapture</span><span class="w"> </span><span class="cp">%}</span>

<span class="cp">{%</span><span class="w"> </span><span class="nt">capture</span><span class="w"> </span><span class="nv">demo_css</span><span class="w"> </span><span class="cp">%}</span>
.hello-button {
  padding: 0.8rem 1rem;
  border: 0;
  border-radius: 999px;
  background: #0250bb;
  color: white;
  font-weight: 800;
}
<span class="cp">{%</span><span class="w"> </span><span class="nt">endcapture</span><span class="w"> </span><span class="cp">%}</span>

<span class="cp">{%</span><span class="w"> </span><span class="nt">capture</span><span class="w"> </span><span class="nv">demo_js</span><span class="w"> </span><span class="cp">%}</span>
document.querySelector("[data-answer]").addEventListener("click", (event) =&gt; {
  event.currentTarget.textContent = "Yes. Ship it.";
});
<span class="cp">{%</span><span class="w"> </span><span class="nt">endcapture</span><span class="w"> </span><span class="cp">%}</span>

<span class="cp">{%</span><span class="w"> </span><span class="nt">include</span><span class="w"> </span>code-playground.html<span class="w"> </span><span class="na">title</span><span class="o">=</span><span class="s2">"Button Demo"</span><span class="w"> </span><span class="na">html</span><span class="o">=</span><span class="nv">demo_html</span><span class="w"> </span><span class="na">css</span><span class="o">=</span><span class="nv">demo_css</span><span class="w"> </span><span class="na">js</span><span class="o">=</span><span class="nv">demo_js</span><span class="w"> </span><span class="cp">%}</span>
</code></pre></div></div>

<h2 id="the-result">The Result</h2>

<section class="code-playground" data-code-playground="" style="--playground-height: 220px;">
  <div class="code-playground__header">
    <h3 class="code-playground__title">Button Demo</h3>
    <div class="code-playground__tabs" role="tablist" aria-label="Switch code playground view">
      <button class="code-playground__tab is-active" type="button" role="tab" aria-selected="true" data-playground-tab="preview">Preview</button>
      <button class="code-playground__tab" type="button" role="tab" aria-selected="false" data-playground-tab="html">HTML</button>
      
        <button class="code-playground__tab" type="button" role="tab" aria-selected="false" data-playground-tab="css">CSS</button>
      
      
        <button class="code-playground__tab" type="button" role="tab" aria-selected="false" data-playground-tab="js">JS</button>
      
    </div>
  </div>

  <div class="code-playground__body">
    <div class="code-playground__panel is-active" role="tabpanel" data-playground-panel="preview">
      <iframe class="code-playground__preview" title="Button Demo preview" sandbox="allow-scripts" loading="lazy" srcdoc="&lt;!doctype html&gt;
&lt;html lang=&quot;en&quot;&gt;
&lt;head&gt;
  &lt;meta charset=&quot;utf-8&quot;&gt;
  &lt;meta name=&quot;viewport&quot; content=&quot;width=device-width, initial-scale=1&quot;&gt;
  &lt;style&gt;
    *,
    *::before,
    *::after {
      box-sizing: border-box;
    }

    *:not(dialog) {
      margin: 0;
    }

    @media (prefers-reduced-motion: no-preference) {
      html {
        interpolate-size: allow-keywords;
      }
    }

    body {
      display: grid;
      place-items: center;
      min-height: 100vh;
      padding: 1rem;
      color: #15141a;
      background: #ffffff;
      font-family: Inter, -apple-system, BlinkMacSystemFont, &quot;Segoe UI&quot;, sans-serif;
      line-height: 1.5;
      -webkit-font-smoothing: antialiased;
    }

    img,
    picture,
    video,
    canvas,
    svg {
      display: block;
      max-width: 100%;
    }

    input,
    button,
    textarea,
    select {
      font: inherit;
    }

    p,
    h1,
    h2,
    h3,
    h4,
    h5,
    h6 {
      overflow-wrap: break-word;
    }

    p {
      text-wrap: pretty;
    }

    h1,
    h2,
    h3,
    h4,
    h5,
    h6 {
      text-wrap: balance;
    }

    #root,
    #__next {
      isolation: isolate;
    }


.hello-button {
  padding: 0.8rem 1rem;
  border: 0;
  border-radius: 999px;
  background: #0250bb;
  color: white;
  cursor: pointer;
  font-weight: 800;
}

  &lt;/style&gt;
&lt;/head&gt;
&lt;body&gt;

&lt;button class=&quot;hello-button&quot; data-answer&gt;Click me&lt;/button&gt;


  &lt;script&gt;

document.querySelector(&quot;[data-answer]&quot;).addEventListener(&quot;click&quot;, (event) =&gt; {
  event.currentTarget.textContent = &quot;Yes. Ship it.&quot;;
});

  &lt;/script&gt;

&lt;/body&gt;
&lt;/html&gt;"></iframe>
    </div>

    <div class="code-playground__panel" role="tabpanel" data-playground-panel="html" hidden="">
      <div class="code-playground__source">
<figure class="highlight"><pre><code class="language-html" data-lang="html"><span class="nt">&lt;button</span> <span class="na">class=</span><span class="s">"hello-button"</span> <span class="na">data-answer</span><span class="nt">&gt;</span>Click me<span class="nt">&lt;/button&gt;</span></code></pre></figure>
</div>
    </div>

    
      <div class="code-playground__panel" role="tabpanel" data-playground-panel="css" hidden="">
        <div class="code-playground__source">
<figure class="highlight"><pre><code class="language-css" data-lang="css"><span class="nc">.hello-button</span> <span class="p">{</span>
  <span class="nl">padding</span><span class="p">:</span> <span class="m">0.8rem</span> <span class="m">1rem</span><span class="p">;</span>
  <span class="nl">border</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="nl">border-radius</span><span class="p">:</span> <span class="m">999px</span><span class="p">;</span>
  <span class="nl">background</span><span class="p">:</span> <span class="nx">#0250bb</span><span class="p">;</span>
  <span class="nl">color</span><span class="p">:</span> <span class="nx">white</span><span class="p">;</span>
  <span class="nl">cursor</span><span class="p">:</span> <span class="nb">pointer</span><span class="p">;</span>
  <span class="nl">font-weight</span><span class="p">:</span> <span class="m">800</span><span class="p">;</span>
<span class="p">}</span></code></pre></figure>
</div>
      </div>
    

    
      <div class="code-playground__panel" role="tabpanel" data-playground-panel="js" hidden="">
        <div class="code-playground__source">
<figure class="highlight"><pre><code class="language-javascript" data-lang="javascript"><span class="nb">document</span><span class="p">.</span><span class="nf">querySelector</span><span class="p">(</span><span class="dl">"</span><span class="s2">[data-answer]</span><span class="dl">"</span><span class="p">).</span><span class="nf">addEventListener</span><span class="p">(</span><span class="dl">"</span><span class="s2">click</span><span class="dl">"</span><span class="p">,</span> <span class="p">(</span><span class="nx">event</span><span class="p">)</span> <span class="o">=&gt;</span> <span class="p">{</span>
  <span class="nx">event</span><span class="p">.</span><span class="nx">currentTarget</span><span class="p">.</span><span class="nx">textContent</span> <span class="o">=</span> <span class="dl">"</span><span class="s2">Yes. Ship it.</span><span class="dl">"</span><span class="p">;</span>
<span class="p">});</span></code></pre></figure>
</div>
      </div>
    
  </div>
</section>

<h2 id="why-this-is-better">Why This Is Better</h2>

<p>The reader can see the result first, then inspect the exact HTML, CSS, and JS that made it happen. That is the contract. No mystery gap between explanation and output.</p>

<p>This is the web at its best: simple parts, composed well, with the machinery left visible.</p>]]></content><author><name></name></author><category term="code" /><summary type="html"><![CDATA[How this blog got a tiny static code playground with preview, HTML, CSS, and JS tabs.]]></summary></entry><entry><title type="html">First Impressions: Chrome DevTools MCP with Claude Code</title><link href="https://goodbran.com/2026/04/29/chrome-devtools-mcp-first-impressions/" rel="alternate" type="text/html" title="First Impressions: Chrome DevTools MCP with Claude Code" /><published>2026-04-29T02:00:00+00:00</published><updated>2026-04-29T02:00:00+00:00</updated><id>https://goodbran.com/2026/04/29/chrome-devtools-mcp-first-impressions</id><content type="html" xml:base="https://goodbran.com/2026/04/29/chrome-devtools-mcp-first-impressions/"><![CDATA[<p>I discovered the <a href="https://github.com/ChromeDevTools/chrome-devtools-mcp">Chrome DevTools MCP server</a> from a <a href="https://www.youtube.com/watch?v=DanTBy6Qazg&amp;list=PLNYkxOF6rcIAcezfL8q0rjt13ufKseL5X&amp;index=6">Google Chrome Developers YouTube video</a>. The idea was intriguing: connect Claude Code directly to my browser via Chrome’s remote debugging protocol.</p>

<h2 id="installation">Installation</h2>

<p>Installing it in Claude Code CLI was straightforward. I added this simple configuration:</p>

<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
  </span><span class="nl">"mcpServers"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
    </span><span class="nl">"chrome-devtools"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
      </span><span class="nl">"command"</span><span class="p">:</span><span class="w"> </span><span class="s2">"npx"</span><span class="p">,</span><span class="w">
      </span><span class="nl">"enabled"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span><span class="w">
      </span><span class="nl">"args"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
        </span><span class="s2">"chrome-devtools-mcp@latest"</span><span class="w">
      </span><span class="p">]</span><span class="w">
    </span><span class="p">}</span><span class="w">
  </span><span class="p">}</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>

<p>I kept it disabled by default for reasons I’ll explain below.</p>

<h2 id="getting-it-to-work">Getting It to Work</h2>

<p>The <code class="language-plaintext highlighter-rouge">--auto-connect</code> feature didn’t work for me—connection would fail silently. After removing that flag and launching a dedicated Chrome instance with remote debugging, it worked:</p>

<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>/Applications/Google<span class="se">\ </span>Chrome.app/Contents/MacOS/Google<span class="se">\ </span>Chrome <span class="se">\</span>
  <span class="nt">--remote-debugging-port</span><span class="o">=</span>9222 <span class="se">\</span>
  <span class="nt">--user-data-dir</span><span class="o">=</span>/tmp/chrome-mcp-profile
</code></pre></div></div>

<p>Using a separate user data directory has a nice side effect: you can log into Google accounts or any websites, and the sessions persist. Pretty convenient.</p>

<h2 id="the-token-cost">The Token Cost</h2>

<p>After just a few queries involving page navigation and screenshots, I burned through approximately <strong>5 million tokens</strong>. The MCP pipes full DOM trees, computed styles, and metadata into the context window. It’s powerful, but expensive.</p>

<h2 id="my-take">My Take</h2>

<p>I’m using <a href="https://app.fireworks.ai/">Fireworks AI</a> with their Firepass plan which helps with the usage. My recommendation: <strong>only enable it when you need it</strong>, not as a default. A few queries and the token count stacks up fast.</p>

<h2 id="terminal-session">Terminal Session</h2>

<p>Here’s what it looks like in practice:</p>

<p><img src="/assets/images/chrome-devtools-mcp-terminal.png" alt="Chrome DevTools MCP terminal session showing Claude interacting with the browser" /></p>

<h2 id="bottom-line">Bottom Line</h2>

<p>It’s genuinely useful having an AI assistant that can “look” at your screen and debug live web pages. Just remember to disable it when you’re done—your token budget will thank you.</p>]]></content><author><name></name></author><category term="tools" /><summary type="html"><![CDATA[My first experience with the Chrome DevTools MCP server - giving Claude the ability to 'see' my browser screen and debug web pages in real-time.]]></summary></entry><entry><title type="html">Chess Opening: The Italian Game</title><link href="https://goodbran.com/2026/04/25/one-simple-chess-opening-the-italian-game/" rel="alternate" type="text/html" title="Chess Opening: The Italian Game" /><published>2026-04-25T04:00:00+00:00</published><updated>2026-04-25T04:00:00+00:00</updated><id>https://goodbran.com/2026/04/25/one-simple-chess-opening-the-italian-game</id><content type="html" xml:base="https://goodbran.com/2026/04/25/one-simple-chess-opening-the-italian-game/"><![CDATA[<p>The <a href="https://en.wikipedia.org/wiki/Italian_Game">Italian Game</a> has been played for over five centuries. It got its name not because it was invented in Italy, but because Italian masters of the 16th and 17th centuries—players like Gioachino Greco and Damiano—wrote about it, studied it, and popularized it. Before there were databases or engines, before anyone knew what “theory” meant, these three moves were already considered the proper way to start a game.</p>

<div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>1. e4 e5
2. Nf3 Nc6
3. Bc4
</code></pre></div></div>

<p>That is the Italian Game. No tricks. No memorization required. Just three moves that have passed the test of time.</p>

<h2 id="why-it-survived-500-years">Why it survived 500 years</h2>

<p>After <code class="language-plaintext highlighter-rouge">1.e4</code>, you stake a claim in the center. After <code class="language-plaintext highlighter-rouge">2.Nf3</code>, you develop a knight <em>and</em> attack that e5 pawn—two birds, one stone. Then <code class="language-plaintext highlighter-rouge">3.Bc4</code> slides your bishop to a diagonal that actually matters, eyeing that f7 square next to Black’s king like a warning shot.</p>

<p>Every move earns its keep. No passengers. No fluff.</p>

<p>Below are the positions in action:</p>

<link rel="stylesheet" href="https://unpkg.com/@chrisoakman/chessboardjs@1.0.0/dist/chessboard-1.0.0.min.css" />

<script src="https://code.jquery.com/jquery-3.5.1.min.js"></script>

<script src="https://unpkg.com/@chrisoakman/chessboardjs@1.0.0/dist/chessboard-1.0.0.min.js"></script>

<div class="italian-static-boards">
  <style>
    .italian-static-boards {
      display: grid;
      gap: 1.5rem;
      margin: 2rem 0;
    }

    .italian-static-boards figure {
      margin: 0;
      text-align: center;
    }

    .italian-static-boards .board-container {
      display: inline-block;
      width: 100%;
      max-width: 400px;
    }

    .italian-static-boards figcaption {
      margin-top: 0.75rem;
      color: var(--text-muted, #555);
      font-size: 0.95rem;
      line-height: 1.5;
      text-align: center;
    }
  </style>

  <figure>
    <div class="board-container" id="italianBoardCenter"></div>
    <figcaption><strong>1.e4 e5</strong>: both sides claim the center. Nothing fancy, just good real estate.</figcaption>
  </figure>

  <figure>
    <div class="board-container" id="italianBoardKnights"></div>
    <figcaption><strong>2.Nf3 Nc6</strong>: White develops with a threat; Black defends and develops. Practical chess.</figcaption>
  </figure>

  <figure>
    <div class="board-container" id="italianBoardBishop"></div>
    <figcaption><strong>3.Bc4</strong>: the bishop eyes f7—that weak spot by the king. Not an immediate threat, just pressure.</figcaption>
  </figure>

  <figure>
    <div class="board-container" id="italianBoardQuiet"></div>
    <figcaption><strong>A quiet continuation</strong>: after <code>3...Bc5 4.c3 Nf6 5.d3 d6</code>, both sides castle and get on with the game.</figcaption>
  </figure>
</div>

<script>
  var pieces = "https://cdn.jsdelivr.net/gh/oakmac/chessboardjs@1.0.0/website/img/chesspieces/wikipedia/{piece}.png";

  var afterCenter = "rnbqkbnr/pppp1ppp/8/4p3/4P3/8/PPPP1PPP/RNBQKBNR";
  var afterKnights = "r1bqkbnr/pppp1ppp/2n5/4p3/4P3/5N2/PPPP1PPP/RNBQKB1R";
  var italianGame = "r1bqkbnr/pppp1ppp/2n5/4p3/2B1P3/5N2/PPPP1PPP/RNBQK2R";
  var quietPlan = "r1bqk2r/ppp2ppp/2np1n2/2b1p3/2B1P3/2PP1N2/PP3PPP/RNBQK2R";

  Chessboard("italianBoardCenter", { position: afterCenter, pieceTheme: pieces });
  Chessboard("italianBoardKnights", { position: afterKnights, pieceTheme: pieces });
  Chessboard("italianBoardBishop", { position: italianGame, pieceTheme: pieces });
  Chessboard("italianBoardQuiet", { position: quietPlan, pieceTheme: pieces });
</script>

<h2 id="what-happens-next">What happens next</h2>

<p>Here’s the beauty of it: after those three moves, you’re just playing chess. Castle your king to safety. Connect your rooks. Develop the rest of your pieces. The opening has done its job—now the middlegame is your playground.</p>

<p>In the 19th century, romantic players like Paul Morphy used this opening to create fireworks. They’d sacrifice pieces left and right, hunting for the king with theatrical flair. Modern players tend to be more restrained, but the core ideas remain: control the center, develop quickly, and keep your king safe.</p>

<h2 id="the-bottom-line">The bottom line</h2>

<p>The Italian Game survived centuries because it follows principles that never go out of style. These three moves are useful even when you forget what they’re called. They let you focus on actually <em>playing</em> instead of reciting memorized engine lines.</p>

<p>You don’t need to know every trap in the book. You need three moves that make sense, and the discipline to follow up with good habits. Castle. Develop. Don’t shuffle the same piece around while your king waits to get mugged.</p>

<p>Start with <code class="language-plaintext highlighter-rouge">1.e4 e5 2.Nf3 Nc6 3.Bc4</code>. Understand why each move works. Then go play some games. The rest you’ll figure out at the board.</p>]]></content><author><name></name></author><category term="chess" /><summary type="html"><![CDATA[A beginner-friendly introduction to the Italian Game: 1.e4 e5 2.Nf3 Nc6 3.Bc4, shown with simple static board examples.]]></summary></entry><entry><title type="html">Create a Pivot Table with HTML and CSS Only</title><link href="https://goodbran.com/2026/04/24/create-a-pivot-table-with-html-and-css-only/" rel="alternate" type="text/html" title="Create a Pivot Table with HTML and CSS Only" /><published>2026-04-24T04:00:00+00:00</published><updated>2026-04-24T04:00:00+00:00</updated><id>https://goodbran.com/2026/04/24/create-a-pivot-table-with-html-and-css-only</id><content type="html" xml:base="https://goodbran.com/2026/04/24/create-a-pivot-table-with-html-and-css-only/"><![CDATA[<p>Use a real <code class="language-plaintext highlighter-rouge">&lt;table&gt;</code>. Wrap it in a scroll box. For sticky rows or columns, use fixed widths, <code class="language-plaintext highlighter-rouge">border-collapse: separate</code>, and draw the borders yourself.</p>

<h2 id="final-shape">Final shape</h2>

<p>Scroll this table sideways and down. The header, first two columns, right Total column, and bottom Grand total row stay visible.</p>

<div class="pivot-demo pivot-demo-final">
  <style>
    .pivot-demo-final {
      --c1: 6rem;
      --c2: 7rem;
      --total: 5.5rem;
    }

    .pivot-demo-final .scroll {
      max-height: 18rem;
      overflow: auto;
    }

    .pivot-demo-final table {
      border-collapse: separate;
      border-spacing: 0;
      table-layout: fixed;
      width: 880px;
      min-width: 880px;
    }

    .pivot-demo-final .c1 { width: var(--c1); }
    .pivot-demo-final .c2 { width: var(--c2); }
    .pivot-demo-final .ct { width: var(--total); }

    .pivot-demo-final th,
    .pivot-demo-final td {
      border: 0;
      border-right: 1px solid #999;
      border-bottom: 1px solid #999;
      padding: 0.35rem 0.5rem;
      white-space: nowrap;
    }

    .pivot-demo-final thead tr:first-child th {
      border-top: 1px solid #999;
    }

    .pivot-demo-final .before-right {
      border-right: 0;
    }

    .pivot-demo-final tbody tr:last-child > *,
    .pivot-demo-final .touch-footer {
      border-bottom: 0;
    }

    .pivot-demo-final th { text-align: left; }
    .pivot-demo-final td { text-align: right; }

    .pivot-demo-final thead {
      position: sticky;
      top: 0;
      z-index: 4;
    }

    .pivot-demo-final tfoot {
      position: sticky;
      bottom: 0;
      z-index: 4;
    }

    .pivot-demo-final thead th,
    .pivot-demo-final tfoot th,
    .pivot-demo-final tfoot td,
    .pivot-demo-final .stick {
      background: var(--bg-body, white);
    }

    .pivot-demo-final tfoot th,
    .pivot-demo-final tfoot td {
      border-top: 1px solid #999;
    }

    .pivot-demo-final .stick {
      position: sticky;
      z-index: 2;
    }

    .pivot-demo-final .left-1 {
      left: 0;
      border-left: 1px solid #999;
      width: var(--c1);
      min-width: var(--c1);
      max-width: var(--c1);
    }

    .pivot-demo-final .left-2 {
      left: var(--c1);
      width: var(--c2);
      min-width: var(--c2);
      max-width: var(--c2);
    }

    .pivot-demo-final .right {
      right: 0;
      border-left: 1px solid #999;
      width: var(--total);
      min-width: var(--total);
      max-width: var(--total);
    }

    .pivot-demo-final .grand-label {
      left: 0;
      border-left: 1px solid #999;
      width: calc(var(--c1) + var(--c2));
      min-width: calc(var(--c1) + var(--c2));
      max-width: calc(var(--c1) + var(--c2));
      z-index: 5;
    }

    .pivot-demo-final thead .stick,
    .pivot-demo-final tfoot .right {
      z-index: 5;
    }
  </style>

  <div class="scroll">
    <table>
      <colgroup>
        <col class="c1" />
        <col class="c2" />
        <col span="6" />
        <col class="ct" />
      </colgroup>
      <thead>
        <tr>
          <th class="stick left-1" rowspan="2">Category</th>
          <th class="stick left-2" rowspan="2">Product</th>
          <th colspan="3">Q1</th>
          <th class="before-right" colspan="3">Q2</th>
          <th class="stick right" rowspan="2">Total</th>
        </tr>
        <tr>
          <th>Jan</th>
          <th>Feb</th>
          <th>Mar</th>
          <th>Apr</th>
          <th>May</th>
          <th class="before-right">Jun</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <th class="stick left-1" rowspan="2">Fruit</th>
          <th class="stick left-2">Apples</th>
          <td>120</td><td>140</td><td>135</td><td>150</td><td>160</td><td class="before-right">170</td>
          <td class="stick right">875</td>
        </tr>
        <tr>
          <th class="stick left-2">Bananas</th>
          <td>90</td><td>100</td><td>95</td><td>110</td><td>115</td><td class="before-right">120</td>
          <td class="stick right">630</td>
        </tr>
        <tr>
          <th class="stick left-1" rowspan="2">Drinks</th>
          <th class="stick left-2">Tea</th>
          <td>60</td><td>65</td><td>70</td><td>75</td><td>80</td><td class="before-right">85</td>
          <td class="stick right">435</td>
        </tr>
        <tr>
          <th class="stick left-2">Coffee</th>
          <td>130</td><td>125</td><td>140</td><td>145</td><td>150</td><td class="before-right">155</td>
          <td class="stick right">845</td>
        </tr>
        <tr>
          <th class="stick left-1 touch-footer" rowspan="2">Snacks</th>
          <th class="stick left-2">Cookies</th>
          <td>75</td><td>80</td><td>85</td><td>90</td><td>95</td><td class="before-right">100</td>
          <td class="stick right">525</td>
        </tr>
        <tr>
          <th class="stick left-2">Chips</th>
          <td>95</td><td>90</td><td>100</td><td>105</td><td>110</td><td class="before-right">115</td>
          <td class="stick right">615</td>
        </tr>
      </tbody>
      <tfoot>
        <tr>
          <th class="stick grand-label" colspan="2">Grand total</th>
          <td>570</td><td>600</td><td>625</td><td>675</td><td>710</td><td class="before-right">745</td>
          <td class="stick right">3925</td>
        </tr>
      </tfoot>
    </table>
  </div>
</div>

<h2 id="how-the-final-shape-works">How the final shape works</h2>

<details>
  <summary>HTML structure</summary>

  <div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c">&lt;!-- Scope wrapper: keeps demo CSS from affecting other tables --&gt;</span>
<span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"pivot-demo pivot-demo-final"</span><span class="nt">&gt;</span>
  <span class="c">&lt;!-- Scroll container: creates horizontal and vertical scroll --&gt;</span>
  <span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"scroll"</span><span class="nt">&gt;</span>
    <span class="nt">&lt;table&gt;</span>
      <span class="c">&lt;!-- Column widths: locks real widths for sticky columns --&gt;</span>
      <span class="nt">&lt;colgroup&gt;</span>
        <span class="nt">&lt;col</span> <span class="na">class=</span><span class="s">"c1"</span><span class="nt">&gt;</span>  <span class="c">&lt;!-- First sticky column --&gt;</span>
        <span class="nt">&lt;col</span> <span class="na">class=</span><span class="s">"c2"</span><span class="nt">&gt;</span>  <span class="c">&lt;!-- Second sticky column --&gt;</span>
        <span class="nt">&lt;col</span> <span class="na">span=</span><span class="s">"6"</span><span class="nt">&gt;</span>    <span class="c">&lt;!-- Six month columns --&gt;</span>
        <span class="nt">&lt;col</span> <span class="na">class=</span><span class="s">"ct"</span><span class="nt">&gt;</span>  <span class="c">&lt;!-- Right Total column --&gt;</span>
      <span class="nt">&lt;/colgroup&gt;</span>

      <span class="nt">&lt;thead&gt;</span>
        <span class="nt">&lt;tr&gt;</span>
          <span class="c">&lt;!-- rowspan="2": makes cells cover both header rows --&gt;</span>
          <span class="nt">&lt;th</span> <span class="na">class=</span><span class="s">"stick left-1"</span> <span class="na">rowspan=</span><span class="s">"2"</span><span class="nt">&gt;</span>Category<span class="nt">&lt;/th&gt;</span>
          <span class="nt">&lt;th</span> <span class="na">class=</span><span class="s">"stick left-2"</span> <span class="na">rowspan=</span><span class="s">"2"</span><span class="nt">&gt;</span>Product<span class="nt">&lt;/th&gt;</span>
          <span class="c">&lt;!-- colspan="3": groups months under quarters --&gt;</span>
          <span class="nt">&lt;th</span> <span class="na">colspan=</span><span class="s">"3"</span><span class="nt">&gt;</span>Q1<span class="nt">&lt;/th&gt;</span>
          <span class="nt">&lt;th</span> <span class="na">class=</span><span class="s">"before-right"</span> <span class="na">colspan=</span><span class="s">"3"</span><span class="nt">&gt;</span>Q2<span class="nt">&lt;/th&gt;</span>
          <span class="c">&lt;!-- Sticky right Total column header --&gt;</span>
          <span class="nt">&lt;th</span> <span class="na">class=</span><span class="s">"stick right"</span> <span class="na">rowspan=</span><span class="s">"2"</span><span class="nt">&gt;</span>Total<span class="nt">&lt;/th&gt;</span>
        <span class="nt">&lt;/tr&gt;</span>
        <span class="nt">&lt;tr&gt;</span>
          <span class="nt">&lt;th&gt;</span>Jan<span class="nt">&lt;/th&gt;&lt;th&gt;</span>Feb<span class="nt">&lt;/th&gt;&lt;th&gt;</span>Mar<span class="nt">&lt;/th&gt;</span>
          <span class="nt">&lt;th&gt;</span>Apr<span class="nt">&lt;/th&gt;&lt;th&gt;</span>May<span class="nt">&lt;/th&gt;</span>
          <span class="c">&lt;!-- before-right: removes border before sticky Total column --&gt;</span>
          <span class="nt">&lt;th</span> <span class="na">class=</span><span class="s">"before-right"</span><span class="nt">&gt;</span>Jun<span class="nt">&lt;/th&gt;</span>
        <span class="nt">&lt;/tr&gt;</span>
      <span class="nt">&lt;/thead&gt;</span>

      <span class="nt">&lt;tbody&gt;</span>
        <span class="nt">&lt;tr&gt;</span>
          <span class="c">&lt;!-- rowspan="2": groups one category across two products --&gt;</span>
          <span class="nt">&lt;th</span> <span class="na">class=</span><span class="s">"stick left-1"</span> <span class="na">rowspan=</span><span class="s">"2"</span><span class="nt">&gt;</span>Fruit<span class="nt">&lt;/th&gt;</span>
          <span class="nt">&lt;th</span> <span class="na">class=</span><span class="s">"stick left-2"</span><span class="nt">&gt;</span>Apples<span class="nt">&lt;/th&gt;</span>
          <span class="nt">&lt;td&gt;</span>120<span class="nt">&lt;/td&gt;&lt;td&gt;</span>140<span class="nt">&lt;/td&gt;&lt;td&gt;</span>135<span class="nt">&lt;/td&gt;</span>
          <span class="nt">&lt;td&gt;</span>150<span class="nt">&lt;/td&gt;&lt;td&gt;</span>160<span class="nt">&lt;/td&gt;</span>
          <span class="nt">&lt;td</span> <span class="na">class=</span><span class="s">"before-right"</span><span class="nt">&gt;</span>170<span class="nt">&lt;/td&gt;</span>
          <span class="c">&lt;!-- Sticky right Total value --&gt;</span>
          <span class="nt">&lt;td</span> <span class="na">class=</span><span class="s">"stick right"</span><span class="nt">&gt;</span>875<span class="nt">&lt;/td&gt;</span>
        <span class="nt">&lt;/tr&gt;</span>
        <span class="c">&lt;!-- More rows... --&gt;</span>
        <span class="nt">&lt;tr&gt;</span>
          <span class="c">&lt;!-- touch-footer: rowspan cell that reaches the sticky footer --&gt;</span>
          <span class="nt">&lt;th</span> <span class="na">class=</span><span class="s">"stick left-1 touch-footer"</span> <span class="na">rowspan=</span><span class="s">"2"</span><span class="nt">&gt;</span>Snacks<span class="nt">&lt;/th&gt;</span>
          <span class="c">&lt;!-- More cells... --&gt;</span>
        <span class="nt">&lt;/tr&gt;</span>
      <span class="nt">&lt;/tbody&gt;</span>

      <span class="c">&lt;!-- tfoot: sticky Grand total row --&gt;</span>
      <span class="nt">&lt;tfoot&gt;</span>
        <span class="nt">&lt;tr&gt;</span>
          <span class="c">&lt;!-- grand-label: spans both left sticky columns --&gt;</span>
          <span class="nt">&lt;th</span> <span class="na">class=</span><span class="s">"stick grand-label"</span> <span class="na">colspan=</span><span class="s">"2"</span><span class="nt">&gt;</span>Grand total<span class="nt">&lt;/th&gt;</span>
          <span class="nt">&lt;td&gt;</span>570<span class="nt">&lt;/td&gt;&lt;td&gt;</span>600<span class="nt">&lt;/td&gt;&lt;td&gt;</span>625<span class="nt">&lt;/td&gt;</span>
          <span class="nt">&lt;td&gt;</span>675<span class="nt">&lt;/td&gt;&lt;td&gt;</span>710<span class="nt">&lt;/td&gt;</span>
          <span class="nt">&lt;td</span> <span class="na">class=</span><span class="s">"before-right"</span><span class="nt">&gt;</span>745<span class="nt">&lt;/td&gt;</span>
          <span class="nt">&lt;td</span> <span class="na">class=</span><span class="s">"stick right"</span><span class="nt">&gt;</span>3925<span class="nt">&lt;/td&gt;</span>
        <span class="nt">&lt;/tr&gt;</span>
      <span class="nt">&lt;/tfoot&gt;</span>
    <span class="nt">&lt;/table&gt;</span>
  <span class="nt">&lt;/div&gt;</span>
<span class="nt">&lt;/div&gt;</span>
</code></pre></div>  </div>

</details>

<details>
  <summary>CSS structure</summary>

  <div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nc">.pivot-demo-final</span> <span class="p">{</span>
  <span class="c">/* Width variables: store column widths in one place */</span>
  <span class="py">--c1</span><span class="p">:</span> <span class="m">6rem</span><span class="p">;</span>
  <span class="py">--c2</span><span class="p">:</span> <span class="m">7rem</span><span class="p">;</span>
  <span class="py">--total</span><span class="p">:</span> <span class="m">5.5rem</span><span class="p">;</span>
<span class="p">}</span>

<span class="c">/* Scroll container: creates horizontal and vertical scrolling */</span>
<span class="nc">.pivot-demo-final</span> <span class="nc">.scroll</span> <span class="p">{</span>
  <span class="nl">max-height</span><span class="p">:</span> <span class="m">18rem</span><span class="p">;</span>
  <span class="nl">overflow</span><span class="p">:</span> <span class="nb">auto</span><span class="p">;</span>
<span class="p">}</span>

<span class="nc">.pivot-demo-final</span> <span class="nt">table</span> <span class="p">{</span>
  <span class="c">/* border-collapse: separate avoids sticky-border bugs from collapsed borders */</span>
  <span class="nl">border-collapse</span><span class="p">:</span> <span class="nb">separate</span><span class="p">;</span>
  <span class="nl">border-spacing</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="c">/* Fixed layout: makes column widths predictable for sticky offsets */</span>
  <span class="nl">table-layout</span><span class="p">:</span> <span class="nb">fixed</span><span class="p">;</span>
  <span class="nl">width</span><span class="p">:</span> <span class="m">880px</span><span class="p">;</span>
  <span class="nl">min-width</span><span class="p">:</span> <span class="m">880px</span><span class="p">;</span>
<span class="p">}</span>

<span class="c">/* Column widths applied through colgroup */</span>
<span class="nc">.pivot-demo-final</span> <span class="nc">.c1</span> <span class="p">{</span> <span class="nl">width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">);</span> <span class="p">}</span>
<span class="nc">.pivot-demo-final</span> <span class="nc">.c2</span> <span class="p">{</span> <span class="nl">width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">);</span> <span class="p">}</span>
<span class="nc">.pivot-demo-final</span> <span class="nc">.ct</span> <span class="p">{</span> <span class="nl">width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--total</span><span class="p">);</span> <span class="p">}</span>

<span class="nc">.pivot-demo-final</span> <span class="nt">th</span><span class="o">,</span>
<span class="nc">.pivot-demo-final</span> <span class="nt">td</span> <span class="p">{</span>
  <span class="c">/* Grid lines: draw right and bottom borders */</span>
  <span class="nl">border</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="nl">border-right</span><span class="p">:</span> <span class="m">1px</span> <span class="nb">solid</span> <span class="nx">#999</span><span class="p">;</span>
  <span class="nl">border-bottom</span><span class="p">:</span> <span class="m">1px</span> <span class="nb">solid</span> <span class="nx">#999</span><span class="p">;</span>
  <span class="nl">padding</span><span class="p">:</span> <span class="m">0.35rem</span> <span class="m">0.5rem</span><span class="p">;</span>
  <span class="nl">white-space</span><span class="p">:</span> <span class="nb">nowrap</span><span class="p">;</span>
<span class="p">}</span>

<span class="c">/* Top border: draws the top edge of the table */</span>
<span class="nc">.pivot-demo-final</span> <span class="nt">thead</span> <span class="nt">tr</span><span class="nd">:first-child</span> <span class="nt">th</span> <span class="p">{</span>
  <span class="nl">border-top</span><span class="p">:</span> <span class="m">1px</span> <span class="nb">solid</span> <span class="nx">#999</span><span class="p">;</span>
<span class="p">}</span>

<span class="c">/* Border fix: removes right border before sticky Total column */</span>
<span class="nc">.pivot-demo-final</span> <span class="nc">.before-right</span> <span class="p">{</span> <span class="nl">border-right</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span> <span class="p">}</span>

<span class="c">/* Border fix: removes bottom border from last body row */</span>
<span class="nc">.pivot-demo-final</span> <span class="nt">tbody</span> <span class="nt">tr</span><span class="nd">:last-child</span> <span class="o">&gt;</span> <span class="o">*,</span>
<span class="nc">.pivot-demo-final</span> <span class="nc">.touch-footer</span> <span class="p">{</span> <span class="nl">border-bottom</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span> <span class="p">}</span>

<span class="c">/* Sticky header: sticks to top while scrolling down */</span>
<span class="nc">.pivot-demo-final</span> <span class="nt">thead</span> <span class="p">{</span>
  <span class="nl">position</span><span class="p">:</span> <span class="nb">sticky</span><span class="p">;</span>
  <span class="nl">top</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="nl">z-index</span><span class="p">:</span> <span class="m">4</span><span class="p">;</span>
<span class="p">}</span>

<span class="c">/* Sticky footer: sticks to bottom while scrolling down */</span>
<span class="nc">.pivot-demo-final</span> <span class="nt">tfoot</span> <span class="p">{</span>
  <span class="nl">position</span><span class="p">:</span> <span class="nb">sticky</span><span class="p">;</span>
  <span class="nl">bottom</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="nl">z-index</span><span class="p">:</span> <span class="m">4</span><span class="p">;</span>
<span class="p">}</span>

<span class="c">/* Background: stops scrolled cells from showing through sticky cells */</span>
<span class="nc">.pivot-demo-final</span> <span class="nt">thead</span> <span class="nt">th</span><span class="o">,</span>
<span class="nc">.pivot-demo-final</span> <span class="nt">tfoot</span> <span class="nt">th</span><span class="o">,</span>
<span class="nc">.pivot-demo-final</span> <span class="nt">tfoot</span> <span class="nt">td</span><span class="o">,</span>
<span class="nc">.pivot-demo-final</span> <span class="nc">.stick</span> <span class="p">{</span>
  <span class="nl">background</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--bg-body</span><span class="p">,</span> <span class="nx">white</span><span class="p">);</span>
<span class="p">}</span>

<span class="c">/* Shared sticky behavior for individual cells */</span>
<span class="nc">.pivot-demo-final</span> <span class="nc">.stick</span> <span class="p">{</span>
  <span class="nl">position</span><span class="p">:</span> <span class="nb">sticky</span><span class="p">;</span>
  <span class="nl">z-index</span><span class="p">:</span> <span class="m">2</span><span class="p">;</span>
<span class="p">}</span>

<span class="c">/* First sticky column: pinned to left edge */</span>
<span class="nc">.pivot-demo-final</span> <span class="nc">.left-1</span> <span class="p">{</span>
  <span class="nl">left</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="nl">border-left</span><span class="p">:</span> <span class="m">1px</span> <span class="nb">solid</span> <span class="nx">#999</span><span class="p">;</span>  <span class="c">/* Draws left edge of table */</span>
  <span class="nl">width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">);</span>
  <span class="nl">min-width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">);</span>
  <span class="nl">max-width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">);</span>
<span class="p">}</span>

<span class="c">/* Second sticky column: positioned after first column */</span>
<span class="nc">.pivot-demo-final</span> <span class="nc">.left-2</span> <span class="p">{</span>
  <span class="nl">left</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">);</span>
  <span class="nl">width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">);</span>
  <span class="nl">min-width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">);</span>
  <span class="nl">max-width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">);</span>
<span class="p">}</span>

<span class="c">/* Right sticky Total column: pinned to right edge */</span>
<span class="nc">.pivot-demo-final</span> <span class="nc">.right</span> <span class="p">{</span>
  <span class="nl">right</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="nl">border-left</span><span class="p">:</span> <span class="m">1px</span> <span class="nb">solid</span> <span class="nx">#999</span><span class="p">;</span>  <span class="c">/* Draws its own left border */</span>
  <span class="nl">width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--total</span><span class="p">);</span>
  <span class="nl">min-width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--total</span><span class="p">);</span>
  <span class="nl">max-width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--total</span><span class="p">);</span>
<span class="p">}</span>

<span class="c">/* Grand total label: spans both left sticky columns */</span>
<span class="nc">.pivot-demo-final</span> <span class="nc">.grand-label</span> <span class="p">{</span>
  <span class="nl">left</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="nl">border-left</span><span class="p">:</span> <span class="m">1px</span> <span class="nb">solid</span> <span class="nx">#999</span><span class="p">;</span>
  <span class="nl">width</span><span class="p">:</span> <span class="nf">calc</span><span class="p">(</span><span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">)</span> <span class="o">+</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">));</span>
  <span class="nl">min-width</span><span class="p">:</span> <span class="nf">calc</span><span class="p">(</span><span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">)</span> <span class="o">+</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">));</span>
  <span class="nl">max-width</span><span class="p">:</span> <span class="nf">calc</span><span class="p">(</span><span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">)</span> <span class="o">+</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">));</span>
  <span class="nl">z-index</span><span class="p">:</span> <span class="m">5</span><span class="p">;</span>
<span class="p">}</span>

<span class="c">/* z-index layering: sticky intersections above normal cells */</span>
<span class="nc">.pivot-demo-final</span> <span class="nt">thead</span> <span class="nc">.stick</span><span class="o">,</span>
<span class="nc">.pivot-demo-final</span> <span class="nt">tfoot</span> <span class="nc">.right</span> <span class="p">{</span>
  <span class="nl">z-index</span><span class="p">:</span> <span class="m">5</span><span class="p">;</span>
<span class="p">}</span>
</code></pre></div>  </div>

</details>

<details>
  <summary>Why the border fixes are necessary</summary>

  <p>Sticky tables are easy to make messy because sticky cells sit above scrolling cells.</p>

  <p><code class="language-plaintext highlighter-rouge">border-collapse: collapse</code> looks simpler, but with sticky cells the borders can appear to move with the scrolling table. <code class="language-plaintext highlighter-rouge">border-collapse: separate</code> plus <code class="language-plaintext highlighter-rouge">border-spacing: 0</code> gives us a clean grid while keeping each border attached to a real cell.</p>

  <p>The Total column draws its own left border. That is why the cell before it uses <code class="language-plaintext highlighter-rouge">.before-right</code>: without it, you see two borders touching each other.</p>

  <p>The sticky footer draws its own top border. That is why the last body row removes its bottom border. If a <code class="language-plaintext highlighter-rouge">rowspan</code> cell reaches the footer, add <code class="language-plaintext highlighter-rouge">.touch-footer</code> to that cell too.</p>

</details>

<h2 id="step-1-make-a-normal-table">Step 1: Make a normal table</h2>

<p>Start with the data. Use <code class="language-plaintext highlighter-rouge">&lt;th&gt;</code> for labels and <code class="language-plaintext highlighter-rouge">&lt;td&gt;</code> for numbers.</p>

<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;table&gt;</span>
  <span class="nt">&lt;thead&gt;</span>
    <span class="nt">&lt;tr&gt;</span>
      <span class="nt">&lt;th&gt;</span>Category<span class="nt">&lt;/th&gt;</span>
      <span class="nt">&lt;th&gt;</span>Product<span class="nt">&lt;/th&gt;</span>
      <span class="nt">&lt;th&gt;</span>Jan<span class="nt">&lt;/th&gt;</span>
      <span class="nt">&lt;th&gt;</span>Total<span class="nt">&lt;/th&gt;</span>
    <span class="nt">&lt;/tr&gt;</span>
  <span class="nt">&lt;/thead&gt;</span>
  <span class="nt">&lt;tbody&gt;</span>
    <span class="nt">&lt;tr&gt;</span>
      <span class="nt">&lt;th&gt;</span>Fruit<span class="nt">&lt;/th&gt;</span>
      <span class="nt">&lt;th&gt;</span>Apples<span class="nt">&lt;/th&gt;</span>
      <span class="nt">&lt;td&gt;</span>120<span class="nt">&lt;/td&gt;</span>
      <span class="nt">&lt;td&gt;</span>120<span class="nt">&lt;/td&gt;</span>
    <span class="nt">&lt;/tr&gt;</span>
  <span class="nt">&lt;/tbody&gt;</span>
<span class="nt">&lt;/table&gt;</span>
</code></pre></div></div>

<h2 id="step-2-merge-cells-with-html">Step 2: Merge cells with HTML</h2>

<p>CSS does not merge table cells. HTML does.</p>

<p>Use <code class="language-plaintext highlighter-rouge">colspan</code> to stretch across columns:</p>

<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;tr&gt;</span>
  <span class="nt">&lt;th</span> <span class="na">rowspan=</span><span class="s">"2"</span><span class="nt">&gt;</span>Category<span class="nt">&lt;/th&gt;</span>
  <span class="nt">&lt;th</span> <span class="na">rowspan=</span><span class="s">"2"</span><span class="nt">&gt;</span>Product<span class="nt">&lt;/th&gt;</span>
  <span class="nt">&lt;th</span> <span class="na">colspan=</span><span class="s">"3"</span><span class="nt">&gt;</span>Q1<span class="nt">&lt;/th&gt;</span>
  <span class="nt">&lt;th</span> <span class="na">rowspan=</span><span class="s">"2"</span><span class="nt">&gt;</span>Total<span class="nt">&lt;/th&gt;</span>
<span class="nt">&lt;/tr&gt;</span>
<span class="nt">&lt;tr&gt;</span>
  <span class="nt">&lt;th&gt;</span>Jan<span class="nt">&lt;/th&gt;</span>
  <span class="nt">&lt;th&gt;</span>Feb<span class="nt">&lt;/th&gt;</span>
  <span class="nt">&lt;th&gt;</span>Mar<span class="nt">&lt;/th&gt;</span>
<span class="nt">&lt;/tr&gt;</span>
</code></pre></div></div>

<p>Use <code class="language-plaintext highlighter-rouge">rowspan</code> to stretch down rows:</p>

<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;tr&gt;</span>
  <span class="nt">&lt;th</span> <span class="na">rowspan=</span><span class="s">"2"</span><span class="nt">&gt;</span>Fruit<span class="nt">&lt;/th&gt;</span>
  <span class="nt">&lt;th&gt;</span>Apples<span class="nt">&lt;/th&gt;</span>
  <span class="nt">&lt;td&gt;</span>120<span class="nt">&lt;/td&gt;</span>
<span class="nt">&lt;/tr&gt;</span>
<span class="nt">&lt;tr&gt;</span>
  <span class="nt">&lt;th&gt;</span>Bananas<span class="nt">&lt;/th&gt;</span>
  <span class="nt">&lt;td&gt;</span>90<span class="nt">&lt;/td&gt;</span>
<span class="nt">&lt;/tr&gt;</span>
</code></pre></div></div>

<h2 id="step-3-add-scroll-before-sticky">Step 3: Add scroll before sticky</h2>

<p>Wide tables should scroll inside a box. The page itself should not become wider.</p>

<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;div</span> <span class="na">class=</span><span class="s">"scroll"</span><span class="nt">&gt;</span>
  <span class="nt">&lt;table&gt;</span>...<span class="nt">&lt;/table&gt;</span>
<span class="nt">&lt;/div&gt;</span>
</code></pre></div></div>

<div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nc">.scroll</span> <span class="p">{</span>
  <span class="nl">overflow</span><span class="p">:</span> <span class="nb">auto</span><span class="p">;</span>
<span class="p">}</span>

<span class="nt">table</span> <span class="p">{</span>
  <span class="nl">min-width</span><span class="p">:</span> <span class="m">880px</span><span class="p">;</span>
<span class="p">}</span>

<span class="nt">th</span><span class="o">,</span>
<span class="nt">td</span> <span class="p">{</span>
  <span class="nl">white-space</span><span class="p">:</span> <span class="nb">nowrap</span><span class="p">;</span>
<span class="p">}</span>
</code></pre></div></div>

<p>If you also want vertical scrolling, add <code class="language-plaintext highlighter-rouge">max-height</code> to the wrapper.</p>

<h2 id="step-4-use-the-sticky-border-pattern">Step 4: Use the sticky border pattern</h2>

<p>This is the minimized CSS pattern behind the final table.</p>

<details>
  <summary>Show the full sticky CSS pattern</summary>

  <p>First, lock the sticky column widths with <code class="language-plaintext highlighter-rouge">&lt;colgroup&gt;</code>:</p>

  <div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;colgroup&gt;</span>
  <span class="nt">&lt;col</span> <span class="na">class=</span><span class="s">"c1"</span><span class="nt">&gt;</span>
  <span class="nt">&lt;col</span> <span class="na">class=</span><span class="s">"c2"</span><span class="nt">&gt;</span>
  <span class="nt">&lt;col</span> <span class="na">span=</span><span class="s">"6"</span><span class="nt">&gt;</span>
  <span class="nt">&lt;col</span> <span class="na">class=</span><span class="s">"ct"</span><span class="nt">&gt;</span>
<span class="nt">&lt;/colgroup&gt;</span>
</code></pre></div>  </div>

  <div class="language-css highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nc">.pivot</span> <span class="p">{</span>
  <span class="py">--c1</span><span class="p">:</span> <span class="m">6rem</span><span class="p">;</span>
  <span class="py">--c2</span><span class="p">:</span> <span class="m">7rem</span><span class="p">;</span>
  <span class="py">--total</span><span class="p">:</span> <span class="m">5.5rem</span><span class="p">;</span>
<span class="p">}</span>

<span class="nc">.pivot</span> <span class="nc">.scroll</span> <span class="p">{</span>
  <span class="nl">max-height</span><span class="p">:</span> <span class="m">18rem</span><span class="p">;</span>
  <span class="nl">overflow</span><span class="p">:</span> <span class="nb">auto</span><span class="p">;</span>
<span class="p">}</span>

<span class="nc">.pivot</span> <span class="nt">table</span> <span class="p">{</span>
  <span class="nl">border-collapse</span><span class="p">:</span> <span class="nb">separate</span><span class="p">;</span>
  <span class="nl">border-spacing</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="nl">table-layout</span><span class="p">:</span> <span class="nb">fixed</span><span class="p">;</span>
  <span class="nl">width</span><span class="p">:</span> <span class="m">880px</span><span class="p">;</span>
<span class="p">}</span>

<span class="nc">.pivot</span> <span class="nc">.c1</span> <span class="p">{</span> <span class="nl">width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">);</span> <span class="p">}</span>
<span class="nc">.pivot</span> <span class="nc">.c2</span> <span class="p">{</span> <span class="nl">width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">);</span> <span class="p">}</span>
<span class="nc">.pivot</span> <span class="nc">.ct</span> <span class="p">{</span> <span class="nl">width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--total</span><span class="p">);</span> <span class="p">}</span>

<span class="nc">.pivot</span> <span class="nt">th</span><span class="o">,</span>
<span class="nc">.pivot</span> <span class="nt">td</span> <span class="p">{</span>
  <span class="nl">border</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span>
  <span class="nl">border-right</span><span class="p">:</span> <span class="m">1px</span> <span class="nb">solid</span> <span class="nx">#999</span><span class="p">;</span>
  <span class="nl">border-bottom</span><span class="p">:</span> <span class="m">1px</span> <span class="nb">solid</span> <span class="nx">#999</span><span class="p">;</span>
  <span class="nl">padding</span><span class="p">:</span> <span class="m">0.35rem</span> <span class="m">0.5rem</span><span class="p">;</span>
  <span class="nl">white-space</span><span class="p">:</span> <span class="nb">nowrap</span><span class="p">;</span>
<span class="p">}</span>

<span class="nc">.pivot</span> <span class="nt">thead</span> <span class="p">{</span> <span class="nl">position</span><span class="p">:</span> <span class="nb">sticky</span><span class="p">;</span> <span class="nl">top</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span> <span class="nl">z-index</span><span class="p">:</span> <span class="m">4</span><span class="p">;</span> <span class="p">}</span>
<span class="nc">.pivot</span> <span class="nt">tfoot</span> <span class="p">{</span> <span class="nl">position</span><span class="p">:</span> <span class="nb">sticky</span><span class="p">;</span> <span class="nl">bottom</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span> <span class="nl">z-index</span><span class="p">:</span> <span class="m">4</span><span class="p">;</span> <span class="p">}</span>

<span class="nc">.pivot</span> <span class="nt">thead</span> <span class="nt">th</span><span class="o">,</span>
<span class="nc">.pivot</span> <span class="nt">tfoot</span> <span class="nt">th</span><span class="o">,</span>
<span class="nc">.pivot</span> <span class="nt">tfoot</span> <span class="nt">td</span><span class="o">,</span>
<span class="nc">.pivot</span> <span class="nc">.stick</span> <span class="p">{</span>
  <span class="nl">background</span><span class="p">:</span> <span class="nx">white</span><span class="p">;</span>
<span class="p">}</span>

<span class="nc">.pivot</span> <span class="nc">.stick</span> <span class="p">{</span> <span class="nl">position</span><span class="p">:</span> <span class="nb">sticky</span><span class="p">;</span> <span class="nl">z-index</span><span class="p">:</span> <span class="m">2</span><span class="p">;</span> <span class="p">}</span>
<span class="nc">.pivot</span> <span class="nc">.left-1</span> <span class="p">{</span> <span class="nl">left</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span> <span class="nl">width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">);</span> <span class="nl">min-width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">);</span> <span class="nl">max-width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">);</span> <span class="p">}</span>
<span class="nc">.pivot</span> <span class="nc">.left-2</span> <span class="p">{</span> <span class="nl">left</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">);</span> <span class="nl">width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">);</span> <span class="nl">min-width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">);</span> <span class="nl">max-width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">);</span> <span class="p">}</span>
<span class="nc">.pivot</span> <span class="nc">.right</span> <span class="p">{</span> <span class="nl">right</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span> <span class="nl">width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--total</span><span class="p">);</span> <span class="nl">min-width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--total</span><span class="p">);</span> <span class="nl">max-width</span><span class="p">:</span> <span class="nf">var</span><span class="p">(</span><span class="l">--total</span><span class="p">);</span> <span class="nl">border-left</span><span class="p">:</span> <span class="m">1px</span> <span class="nb">solid</span> <span class="nx">#999</span><span class="p">;</span> <span class="p">}</span>
<span class="nc">.pivot</span> <span class="nc">.grand-label</span> <span class="p">{</span> <span class="nl">left</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span> <span class="nl">width</span><span class="p">:</span> <span class="nf">calc</span><span class="p">(</span><span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">)</span> <span class="o">+</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">));</span> <span class="nl">min-width</span><span class="p">:</span> <span class="nf">calc</span><span class="p">(</span><span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">)</span> <span class="o">+</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">));</span> <span class="nl">max-width</span><span class="p">:</span> <span class="nf">calc</span><span class="p">(</span><span class="nf">var</span><span class="p">(</span><span class="l">--c1</span><span class="p">)</span> <span class="o">+</span> <span class="nf">var</span><span class="p">(</span><span class="l">--c2</span><span class="p">));</span> <span class="p">}</span>

<span class="nc">.pivot</span> <span class="nc">.before-right</span> <span class="p">{</span> <span class="nl">border-right</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span> <span class="p">}</span>
<span class="nc">.pivot</span> <span class="nt">tfoot</span> <span class="nt">th</span><span class="o">,</span>
<span class="nc">.pivot</span> <span class="nt">tfoot</span> <span class="nt">td</span> <span class="p">{</span> <span class="nl">border-top</span><span class="p">:</span> <span class="m">1px</span> <span class="nb">solid</span> <span class="nx">#999</span><span class="p">;</span> <span class="p">}</span>
<span class="nc">.pivot</span> <span class="nt">tbody</span> <span class="nt">tr</span><span class="nd">:last-child</span> <span class="o">&gt;</span> <span class="o">*,</span>
<span class="nc">.pivot</span> <span class="nc">.touch-footer</span> <span class="p">{</span> <span class="nl">border-bottom</span><span class="p">:</span> <span class="m">0</span><span class="p">;</span> <span class="p">}</span>
</code></pre></div>  </div>

</details>

<p>The important border fixes are <code class="language-plaintext highlighter-rouge">before-right</code>, <code class="language-plaintext highlighter-rouge">border-top</code> on the footer, and <code class="language-plaintext highlighter-rouge">touch-footer</code> for a rowspanning cell that reaches the footer.</p>

<h2 id="step-5-add-the-sticky-classes">Step 5: Add the sticky classes</h2>

<p>The classes are boring, but they make the table predictable.</p>

<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;th</span> <span class="na">class=</span><span class="s">"stick left-1"</span> <span class="na">rowspan=</span><span class="s">"2"</span><span class="nt">&gt;</span>Category<span class="nt">&lt;/th&gt;</span>
<span class="nt">&lt;th</span> <span class="na">class=</span><span class="s">"stick left-2"</span><span class="nt">&gt;</span>Apples<span class="nt">&lt;/th&gt;</span>
<span class="nt">&lt;td</span> <span class="na">class=</span><span class="s">"before-right"</span><span class="nt">&gt;</span>170<span class="nt">&lt;/td&gt;</span>
<span class="nt">&lt;td</span> <span class="na">class=</span><span class="s">"stick right"</span><span class="nt">&gt;</span>875<span class="nt">&lt;/td&gt;</span>
<span class="nt">&lt;th</span> <span class="na">class=</span><span class="s">"stick grand-label"</span> <span class="na">colspan=</span><span class="s">"2"</span><span class="nt">&gt;</span>Grand total<span class="nt">&lt;/th&gt;</span>
</code></pre></div></div>

<p>Use <code class="language-plaintext highlighter-rouge">touch-footer</code> only when a <code class="language-plaintext highlighter-rouge">rowspan</code> cell reaches the footer but starts before the last row:</p>

<div class="language-html highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">&lt;th</span> <span class="na">class=</span><span class="s">"stick left-1 touch-footer"</span> <span class="na">rowspan=</span><span class="s">"2"</span><span class="nt">&gt;</span>Snacks<span class="nt">&lt;/th&gt;</span>
</code></pre></div></div>

<h2 id="checklist">Checklist</h2>

<ul>
  <li>Use <code class="language-plaintext highlighter-rouge">&lt;table&gt;</code>, not divs.</li>
  <li>Use <code class="language-plaintext highlighter-rouge">colspan</code> and <code class="language-plaintext highlighter-rouge">rowspan</code> for merged cells.</li>
  <li>Put scroll on a wrapper.</li>
  <li>Use fixed widths for sticky columns.</li>
  <li>Use <code class="language-plaintext highlighter-rouge">border-collapse: separate</code> for sticky tables.</li>
  <li>Give sticky cells a background.</li>
  <li>Let sticky footer and sticky total cells draw their own borders.</li>
</ul>

<p>That is enough for a readable static pivot table with only HTML and CSS.</p>]]></content><author><name></name></author><category term="code" /><summary type="html"><![CDATA[A beginner-friendly guide to building a static pivot-table layout with only HTML and CSS, focusing on scroll, borders, sticky totals, and merged cells.]]></summary></entry><entry><title type="html">Welcome to the New Goodbran Blog</title><link href="https://goodbran.com/2026/04/21/welcome-to-the-new-goodbran-blog/" rel="alternate" type="text/html" title="Welcome to the New Goodbran Blog" /><published>2026-04-21T04:00:00+00:00</published><updated>2026-04-21T04:00:00+00:00</updated><id>https://goodbran.com/2026/04/21/welcome-to-the-new-goodbran-blog</id><content type="html" xml:base="https://goodbran.com/2026/04/21/welcome-to-the-new-goodbran-blog/"><![CDATA[<p>The Goodbran blog has been rebuilt from the ground up using <a href="https://jekyllrb.com/">Jekyll</a> — a static site generator that transforms plain text into static websites and blogs.</p>

<h2 id="why-jekyll">Why Jekyll?</h2>

<p>Moving from a Rails-based content system to Jekyll offers several advantages:</p>

<ul>
  <li><strong>Speed</strong>: Static pages load incredibly fast</li>
  <li><strong>Security</strong>: No database or server-side code means fewer attack vectors</li>
  <li><strong>Simplicity</strong>: Write in Markdown, deploy to any static host</li>
  <li><strong>Version Control</strong>: All content lives in Git</li>
</ul>

<h2 id="mozilla-protocol-design-system">Mozilla Protocol Design System</h2>

<p>The new design is inspired by <a href="https://protocol.mozilla.org/">Mozilla Protocol</a> — a design system that emphasizes:</p>

<ul>
  <li>Clean, readable typography with Zilla Slab for headings</li>
  <li>Firefox blue accents (#0060DF) for calls-to-action</li>
  <li>Card-based layouts for content organization</li>
  <li>Accessibility-first approach</li>
</ul>

<h2 id="whats-next">What’s Next</h2>

<p>Over the coming weeks, I’ll be migrating the existing blog posts from the Rails application. This includes:</p>

<ul>
  <li>Technical tutorials on Rails and deployment</li>
  <li>Music notation guides using LilyPond</li>
  <li>Piano scores and sheet music</li>
</ul>

<p>Stay tuned for more content!</p>

<hr />

<p><em>This blog is open source. Find a bug or want to suggest an improvement? <a href="https://github.com/goodbran/goodbran.github.io">Open an issue on GitHub</a>.</em></p>]]></content><author><name></name></author><category term="code" /><summary type="html"><![CDATA[Introducing the new Jekyll-powered blog with Mozilla Protocol design system.]]></summary></entry></feed>