Sticky Steps: sticky scroll section, no GSAP

With your AI

Just ask.

Say it to your AI. It gets the exact code below, not its best guess, and knows where it goes.

Explain how my product works with Kodza Sticky Steps.

Not plugged in yet?

claude mcp add -t http kodza https://kodza.dev/api/mcp

Also in Codex, Cursor and VS Code.

kodza-sticky-steps.html

<section class="kodza-steps">
  <div class="kodza-steps__media">
    <div class="kodza-steps__frame">
      <img class="kodza-steps__image" src="https://kodza.dev/media/kz-steps-1400.webp" alt="">
      <img class="kodza-steps__image" src="https://kodza.dev/media/kz-block-1400.webp" alt="">
      <img class="kodza-steps__image" src="https://kodza.dev/media/kz-stack-1400.webp" alt="">
      <img class="kodza-steps__image" src="https://kodza.dev/media/kz-float-1400.webp" alt="">
      <p class="kodza-steps__counter" aria-hidden="true">
        <span class="kodza-steps__num">01</span>
        <span class="kodza-steps__total">/ 04</span>
        <span class="kodza-steps__bars"></span>
      </p>
    </div>
  </div>
  <ol class="kodza-steps__list">
    <li class="kodza-steps__step">
      <p class="kodza-steps__index">01</p>
      <h2 class="kodza-steps__title">Find it</h2>
      <p class="kodza-steps__text">Search, filter, or scroll the catalogue like it is 2009 and you have all afternoon.</p>
    </li>
    <li class="kodza-steps__step">
      <p class="kodza-steps__index">02</p>
      <h2 class="kodza-steps__title">Copy it</h2>
      <p class="kodza-steps__text">Three tabs, one button. The clipboard does the heavy lifting, as it should.</p>
    </li>
    <li class="kodza-steps__step">
      <p class="kodza-steps__index">03</p>
      <h2 class="kodza-steps__title">Paste it</h2>
      <p class="kodza-steps__text">WordPress, Webflow, a page written by hand in 2014. It does not ask where it is.</p>
    </li>
    <li class="kodza-steps__step">
      <p class="kodza-steps__index">04</p>
      <h2 class="kodza-steps__title">Ship it</h2>
      <p class="kodza-steps__text">Push to production. On a Friday, if you must. We will not tell anyone.</p>
    </li>
  </ol>
</section>

kodza-sticky-steps.css

/* Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license */
/* Kodza — Sticky Steps
   A story told while scrolling: a picture pinned on one side, steps scrolling on the other.
   When a step reaches the middle of the screen, its picture is drawn over the previous one
   like a curtain (from below going down, from above going back up), the counter rolls to
   its number and the bars fill. One image per step, in the same order.
   Everything is tuned with the --kz-steps-* variables. */
.kodza-steps {
  --kz-steps-fg: #0a0a0a;
  --kz-steps-muted: rgba(10, 10, 10, 0.62);
  --kz-steps-glass: rgba(255, 255, 255, 0.78);
  --kz-steps-line: rgba(10, 10, 10, 0.12);
  --kz-steps-top: 10vh;
  --kz-steps-height: 80vh;
  --kz-steps-step: 72vh;
  --kz-steps-radius: 20px;
  --kz-steps-duration: 1s;
  --kz-steps-ease: cubic-bezier(0.65, 0, 0.35, 1);
  --kz-steps-out: cubic-bezier(0.22, 1, 0.36, 1);

  display: grid;
  grid-template-columns: minmax(0, 1.15fr) minmax(0, 1fr);
  gap: 64px;
  color: var(--kz-steps-fg);
}

/* The pinned picture */
.kodza-steps__media {
  position: sticky;
  top: var(--kz-steps-top);
  align-self: start;
  height: var(--kz-steps-height);
}

.kodza-steps__frame {
  position: relative;
  height: 100%;
  overflow: hidden;
  border-radius: var(--kz-steps-radius);
  isolation: isolate;
}

/* Each picture waits outside its curtain; the current one is drawn over the one before */
.kodza-steps__image {
  position: absolute;
  inset: 0;
  z-index: 0;
  width: 100%;
  height: 100%;
  object-fit: cover;
  clip-path: inset(var(--kz-from-top, 100%) 0 var(--kz-from-bottom, 0) 0);
  transform: scale(1.08);
}

.kodza-steps__image.is-leaving {
  z-index: 1;
  clip-path: inset(0);
  transform: translateY(calc(var(--kz-steps-dir, 1) * -3%)) scale(1.02);
  transition: transform var(--kz-steps-duration) var(--kz-steps-ease);
}

.kodza-steps__image.is-active {
  z-index: 2;
  clip-path: inset(0);
  transform: none;
}

.kodza-steps.is-live .kodza-steps__image.is-active {
  transition:
    clip-path var(--kz-steps-duration) var(--kz-steps-ease),
    transform calc(var(--kz-steps-duration) * 1.4) var(--kz-steps-out);
}

/* The counter: a glass pill, its number rolling, one bar per step */
.kodza-steps__counter {
  position: absolute;
  bottom: 16px;
  left: 16px;
  z-index: 3;
  display: flex;
  align-items: center;
  gap: 6px;
  margin: 0;
  padding: 8px 14px;
  border-radius: 999px;
  background: var(--kz-steps-glass);
  -webkit-backdrop-filter: blur(14px) saturate(1.3);
  backdrop-filter: blur(14px) saturate(1.3);
  color: var(--kz-steps-fg);
  font-family: ui-monospace, "SF Mono", Menlo, monospace;
  font-size: 12px;
  font-variant-numeric: tabular-nums;
}

.kodza-steps__num {
  display: inline-grid;
  overflow: hidden;
}

.kodza-steps__num > span {
  grid-area: 1 / 1;
}

.kodza-steps__total {
  color: var(--kz-steps-muted);
}

.kodza-steps__bars {
  display: flex;
  gap: 3px;
  margin-left: 8px;
}

.kodza-steps__bar {
  width: 14px;
  height: 2px;
  overflow: hidden;
  border-radius: 2px;
  background: var(--kz-steps-line);
}

.kodza-steps__bar::after {
  content: "";
  display: block;
  height: 100%;
  background: var(--kz-steps-fg);
  transform: scaleX(0);
  transform-origin: left;
  transition: transform 0.5s var(--kz-steps-out);
}

.kodza-steps__bar.is-on::after {
  transform: none;
}

/* The steps: the one in the middle of the screen is lit */
.kodza-steps__list {
  margin: 0;
  padding: 0;
  list-style: none;
}

.kodza-steps__step {
  display: flex;
  flex-direction: column;
  justify-content: center;
  min-height: var(--kz-steps-step);
  opacity: 0.28;
  transition: opacity 0.5s ease;
}

.kodza-steps__step.is-active {
  opacity: 1;
}

.kodza-steps__index {
  margin: 0 0 16px;
  font-family: ui-monospace, "SF Mono", Menlo, monospace;
  font-size: 12px;
  color: var(--kz-steps-muted);
}

.kodza-steps__title {
  margin: 0;
  font-size: clamp(32px, 4vw, 56px);
  font-weight: 600;
  line-height: 1;
  letter-spacing: -0.045em;
}

.kodza-steps__text {
  max-width: 24em;
  margin: 20px 0 0;
  font-size: 17px;
  line-height: 1.55;
  color: var(--kz-steps-muted);
  text-wrap: pretty;
}

/* Small screens: the picture pinned on top, the steps passing under it */
@media (max-width: 860px) {
  .kodza-steps {
    grid-template-columns: minmax(0, 1fr);
    gap: 0;
  }

  .kodza-steps__media {
    top: 12px;
    z-index: 2;
    height: 44vh;
  }

  .kodza-steps__step {
    min-height: 56vh;
    justify-content: flex-end;
    padding-bottom: 8vh;
  }
}

@media (prefers-reduced-motion: reduce) {
  .kodza-steps.is-live .kodza-steps__image.is-active,
  .kodza-steps__image.is-leaving,
  .kodza-steps__bar::after,
  .kodza-steps__step {
    transition-duration: 0.01ms !important;
  }
}

/* Theming example — on a dark background:
.dark-section .kodza-steps {
  --kz-steps-fg: #f2f2f0;
  --kz-steps-muted: rgba(242, 242, 240, 0.62);
  --kz-steps-glass: rgba(22, 22, 22, 0.72);
  --kz-steps-line: rgba(255, 255, 255, 0.16);
}
*/

/* kodza-guard 0864600af1d2 — generated by Kodza, do not edit.
   Theme guard: keeps a site's own CSS (WordPress themes, Bootstrap, CSS resets…) off this
   component. :not(#_) is always true and weighs as much as an id, so these lines win over
   theme rules made of classes and tags. Customise the component through its --kz-* variables. */

/* What the browser gives, where the component sets it only in some states: at the lowest weight, so its own rules below put it back */

:where(.kodza-steps__image):not(#_) {
  transition: revert;
}

:where(.kodza-steps__step):not(#_) {
  padding-bottom: revert;
}

/* What the browser gives, on everything the component leaves to it */

.kodza-steps:not(#_),
.kodza-steps__media:not(#_),
.kodza-steps__frame:not(#_),
.kodza-steps__num:not(#_),
.kodza-steps__total:not(#_),
.kodza-steps__bars:not(#_),
.kodza-steps__bar:not(#_),
.kodza-steps__num span:where(:not([class*="kodza-"])):not(#_) {
  box-sizing: revert;
}

.kodza-steps__image:not(#_) {
  border: revert;
  margin: revert;
  padding: revert;
  border-radius: revert;
  outline: revert;
  text-decoration: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  background-color: revert;
  background-image: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  color: revert;
  font-family: revert;
  font-size: revert;
  font-weight: revert;
  font-style: revert;
  line-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-steps__counter:not(#_) {
  border: revert;
  outline: revert;
  text-decoration: revert;
  transition: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  font-weight: revert;
  font-style: revert;
  line-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-steps__list:not(#_) {
  border: revert;
  border-radius: revert;
  outline: revert;
  text-decoration: revert;
  transition: revert;
  box-sizing: revert;
  float: revert;
  position: revert;
  background-color: revert;
  background-image: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  color: revert;
  font-family: revert;
  font-size: revert;
  font-weight: revert;
  font-style: revert;
  line-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-steps__step:not(#_) {
  border: revert;
  margin: revert;
  border-radius: revert;
  outline: revert;
  text-decoration: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  position: revert;
  padding-top: revert;
  padding-right: revert;
  padding-left: revert;
  background-color: revert;
  background-image: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  color: revert;
  font-family: revert;
  font-size: revert;
  font-weight: revert;
  font-style: revert;
  line-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-steps__index:not(#_) {
  border: revert;
  padding: revert;
  border-radius: revert;
  outline: revert;
  text-decoration: revert;
  transition: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  position: revert;
  background-color: revert;
  background-image: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  font-weight: revert;
  font-style: revert;
  line-height: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-steps__title:not(#_) {
  border: revert;
  padding: revert;
  border-radius: revert;
  outline: revert;
  text-decoration: revert;
  transition: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  position: revert;
  background-color: revert;
  background-image: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-width: revert;
  max-height: revert;
  color: revert;
  font-family: revert;
  font-style: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-steps__text:not(#_) {
  border: revert;
  padding: revert;
  border-radius: revert;
  outline: revert;
  text-decoration: revert;
  transition: revert;
  list-style: revert;
  box-sizing: revert;
  float: revert;
  position: revert;
  background-color: revert;
  background-image: revert;
  box-shadow: revert;
  outline-offset: revert;
  appearance: revert;
  max-height: revert;
  font-family: revert;
  font-weight: revert;
  font-style: revert;
  letter-spacing: revert;
  text-transform: revert;
  text-underline-offset: revert;
  text-align: revert;
  text-indent: revert;
  text-shadow: revert;
  vertical-align: revert;
}

.kodza-steps__image:not(#_):where(:not([hidden])),
.kodza-steps__list:not(#_):where(:not([hidden])),
.kodza-steps__index:not(#_):where(:not([hidden])),
.kodza-steps__title:not(#_):where(:not([hidden])),
.kodza-steps__text:not(#_):where(:not([hidden])) {
  display: revert;
}

.kodza-steps__image:not(#_):where([hidden]),
.kodza-steps__list:not(#_):where([hidden]),
.kodza-steps__index:not(#_):where([hidden]),
.kodza-steps__title:not(#_):where([hidden]),
.kodza-steps__text:not(#_):where([hidden]) {
  display: none;
}

.kodza-steps__bar:not(#_)::after {
  box-sizing: revert;
}

/* The component's own rules, one step stronger: real buttons and fields, what it sets on tags themes style (links, lists, headings, images…), and the root width (a theme may narrow it, never widen it) */

.kodza-steps__image:not(#_) {
  position: absolute;
}

.kodza-steps__image.is-leaving:not(#_) {
  transition: transform var(--kz-steps-duration) var(--kz-steps-ease);
}

.kodza-steps.is-live .kodza-steps__image.is-active:not(#_) {
  transition: clip-path var(--kz-steps-duration) var(--kz-steps-ease),
    transform calc(var(--kz-steps-duration) * 1.4) var(--kz-steps-out);
}

.kodza-steps__counter:not(#_) {
  position: absolute;
  display: flex;
  margin: 0;
  padding: 8px 14px;
  border-radius: 999px;
  background: var(--kz-steps-glass);
  color: var(--kz-steps-fg);
  font-family: ui-monospace, "SF Mono", Menlo, monospace;
  font-size: 12px;
}

.kodza-steps__list:not(#_) {
  margin: 0;
  padding: 0;
  list-style: none;
}

.kodza-steps__step:not(#_) {
  display: flex;
  transition: opacity 0.5s ease;
}

.kodza-steps__index:not(#_) {
  margin: 0 0 16px;
  font-family: ui-monospace, "SF Mono", Menlo, monospace;
  font-size: 12px;
  color: var(--kz-steps-muted);
}

.kodza-steps__title:not(#_) {
  margin: 0;
  font-size: clamp(32px, 4vw, 56px);
  font-weight: 600;
  line-height: 1;
  letter-spacing: -0.045em;
}

.kodza-steps__text:not(#_) {
  max-width: 24em;
  margin: 20px 0 0;
  font-size: 17px;
  line-height: 1.55;
  color: var(--kz-steps-muted);
}

@media (max-width: 860px) {
  .kodza-steps__step:not(#_) {
    padding-bottom: 8vh;
  }
}

@media (prefers-reduced-motion: reduce) {
  .kodza-steps.is-live .kodza-steps__image.is-active:not(#_),
  .kodza-steps__image.is-leaving:not(#_),
  .kodza-steps__step:not(#_) {
    transition-duration: 0.01ms !important;
  }
}

kodza-sticky-steps.js

// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Kodza — Sticky Steps
// Watches which step crosses the middle of the screen (lower down on small screens), draws
// its picture over the previous one in the direction of travel, rolls the counter and fills
// the bars. Fires "kodza:step" with { step } (0-based) on the section.
(() => {
  const SELECTOR = '.kodza-steps';
  const reduceMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
  const small = window.matchMedia('(max-width: 860px)');
  const pad = (n) => String(n).padStart(2, '0');

  // One instance. Everything it starts is tied to `signal`, so kodza:destroy stops it all
  function mount(root, signal) {
    const steps = [...root.querySelectorAll('.kodza-steps__step')];
    const images = [...root.querySelectorAll('.kodza-steps__image')];
    const num = root.querySelector('.kodza-steps__num');
    const total = root.querySelector('.kodza-steps__total');
    const barsBox = root.querySelector('.kodza-steps__bars');
    if (!steps.length) return;
    const style = getComputedStyle(root);
    const duration = reduceMotion ? 0 : parseFloat(style.getPropertyValue('--kz-steps-duration')) * 1000 || 1000;

    if (total) total.textContent = `/ ${pad(steps.length)}`;
    const bars = steps.map(() => {
      const bar = document.createElement('span');
      bar.className = 'kodza-steps__bar';
      barsBox?.append(bar);
      return bar;
    });
    if (num) num.replaceChildren(Object.assign(document.createElement('span'), { textContent: pad(1) }));

    // The counter: the old number leaves upwards (or downwards going back), the new one arrives
    const roll = (text, dir) => {
      if (!num) return;
      const prev = num.lastElementChild;
      if (prev.textContent === text) return;
      const span = document.createElement('span');
      span.textContent = text;
      num.append(span);
      if (!duration) return prev.remove();
      const timing = { duration: duration * 0.7, easing: 'cubic-bezier(0.22, 1, 0.36, 1)' };
      prev.animate([{ transform: 'none' }, { transform: `translateY(${dir * -110}%)` }], { ...timing, fill: 'forwards' }).finished.then(() => prev.remove());
      span.animate([{ transform: `translateY(${dir * 110}%)` }, { transform: 'none' }], timing);
    };

    let current = -1;
    let timer = 0;
    const activate = (index) => {
      if (index === current || index < 0) return;
      const dir = index > current ? 1 : -1;
      root.style.setProperty('--kz-steps-dir', dir);
      steps.forEach((step, i) => {
        step.classList.toggle('is-active', i === index);
        if (i === index) step.setAttribute('aria-current', 'step');
        else step.removeAttribute('aria-current');
      });
      bars.forEach((bar, i) => bar.classList.toggle('is-on', i <= index));

      // The new picture starts behind its curtain on the side we come from, then draws over
      const next = images[index];
      const prev = images[current];
      if (next && next !== prev) {
        images.forEach((image) => image !== prev && image !== next && image.classList.remove('is-active', 'is-leaving'));
        next.classList.remove('is-active', 'is-leaving');
        next.style.setProperty('--kz-from-top', dir > 0 ? '100%' : '0%');
        next.style.setProperty('--kz-from-bottom', dir > 0 ? '0%' : '100%');
        void next.offsetWidth;
        if (prev) {
          prev.classList.remove('is-active');
          prev.classList.add('is-leaving');
        }
        next.classList.add('is-active');
        clearTimeout(timer);
        timer = setTimeout(() => prev?.classList.remove('is-leaving'), duration);
      }
      if (current >= 0) roll(pad(index + 1), dir);
      current = index;
      root.dispatchEvent(new CustomEvent('kodza:step', { detail: { step: index }, bubbles: true }));
    };

    // The step crossing a line across the screen: the middle, or lower on small screens
    let observer;
    const watch = () => {
      observer?.disconnect();
      const margin = small.matches ? '-70% 0px -29% 0px' : '-50% 0px -49% 0px';
      observer = new IntersectionObserver((entries) => {
        entries.forEach((entry) => entry.isIntersecting && activate(steps.indexOf(entry.target)));
      }, { rootMargin: margin });
      steps.forEach((step) => observer.observe(step));
    };
    small.addEventListener?.('change', watch, { signal });
    watch();
    signal.addEventListener('abort', () => observer.disconnect());

    activate(0);
    requestAnimationFrame(() => !signal.aborted && root.classList.add('is-live'));
  }

  // Kodza lifecycle, the same in every component: `kodza:init` starts the instances inside
  // event.detail.root (the whole page by default), `kodza:destroy` stops them and puts their
  // markup back. For themes and apps that swap content without a page load.
  const instances = new WeakMap();
  const find = (scope = document) => [scope, ...scope.querySelectorAll(SELECTOR)].filter((el) => el.matches?.(SELECTOR));
  const init = (scope) => find(scope).forEach((root) => {
    if (root.classList.contains('is-ready')) return; // already running, maybe from another copy of this script
    const controller = new AbortController();
    instances.set(root, { controller, html: root.innerHTML, attrs: [...root.attributes].map((a) => [a.name, a.value]) });
    mount(root, controller.signal);
    root.classList.add('is-ready');
  });
  const destroy = (scope) => find(scope).forEach((root) => {
    const instance = instances.get(root);
    if (!instance) return;
    instances.delete(root);
    instance.controller.abort();
    [...root.attributes].forEach((a) => root.removeAttribute(a.name));
    instance.attrs.forEach(([name, value]) => root.setAttribute(name, value));
    root.innerHTML = instance.html;
  });
  document.addEventListener('kodza:init', (event) => init(event.detail?.root));
  document.addEventListener('kodza:destroy', (event) => destroy(event.detail?.root));
  init();
  // Loaded in <head>, the script runs before the markup exists: once more when it is parsed
  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', () => init(), { once: true });
})();

StickySteps.tsx

'use client';
// Kodza — Sticky Steps, for React. From https://kodza.dev/components/sticky-steps/
// Kodza License: free to use, client work included. Not to resell or redistribute, ported or not: https://kodza.dev/docs/#print-license
// Next to this file: sticky-steps.css and sticky-steps.js, the component's CSS and JS from Kodza, as they are.
// Yours to edit: the markup is plain JSX below.
// The script changes this markup once React has rendered it (it adds layers, splits text, moves
// nodes), so React must not patch it afterwards. When a prop changes, the key gives React a fresh
// element: kodza:destroy stops the script on the old one, kodza:init starts it on the new one.
import { useRef, useEffect, type ComponentPropsWithoutRef, type ComponentRef, type CSSProperties } from 'react';
import './sticky-steps.css';

export type StickyStepsProps = Omit<ComponentPropsWithoutRef<'section'>, "children" | "vars" | "onStep"> & {
  /** Settings, as CSS variables on the root */
  vars?: {
    /** default: #0a0a0a */
    "--kz-steps-fg"?: string | number;
    /** default: rgba(10, 10, 10, 0.62) */
    "--kz-steps-muted"?: string | number;
    /** default: rgba(255, 255, 255, 0.78) */
    "--kz-steps-glass"?: string | number;
    /** default: rgba(10, 10, 10, 0.12) */
    "--kz-steps-line"?: string | number;
    /** default: 10vh */
    "--kz-steps-top"?: string | number;
    /** default: 80vh */
    "--kz-steps-height"?: string | number;
    /** default: 72vh */
    "--kz-steps-step"?: string | number;
    /** default: 20px */
    "--kz-steps-radius"?: string | number;
    /** default: 1s */
    "--kz-steps-duration"?: string | number;
    /** default: cubic-bezier(0.65, 0, 0.35, 1) */
    "--kz-steps-ease"?: string | number;
    /** default: cubic-bezier(0.22, 1, 0.36, 1) */
    "--kz-steps-out"?: string | number;
  };
  /** "kodza:step", fired by the script (bubbles from the root) */
  onStep?: (event: CustomEvent) => void;
  className?: string;
};

export function StickySteps({ vars, onStep, className, style, ...rest }: StickyStepsProps) {
  const ref = useRef<ComponentRef<'section'>>(null);
  const classes = ["kodza-steps", className].filter(Boolean).join(' ');
  // Everything the markup is made of: when it changes, React gets a fresh element (see the top)
  const key = JSON.stringify([classes, vars, style, rest]);

  // Starts the script on this element once React has rendered it, stops it when it goes
  useEffect(() => {
    const root = ref.current;
    let live = true;
    // @ts-ignore: a plain script, no types to find
    import('./sticky-steps.js').then(() => {
      if (live) document.dispatchEvent(new CustomEvent('kodza:init', { detail: { root } }));
    });
    return () => {
      live = false;
      document.dispatchEvent(new CustomEvent('kodza:destroy', { detail: { root } }));
    };
  }, [key]);

  useEffect(() => {
    const root = ref.current;
    if (!root || !onStep) return;
    const listener = (event: Event) => onStep(event as CustomEvent);
    root.addEventListener("kodza:step", listener);
    return () => root.removeEventListener("kodza:step", listener);
  }, [onStep, key]);

  return (
    <section key={key} {...rest} className={classes} style={{ ...vars, ...style } as CSSProperties} ref={ref}>
      <div className="kodza-steps__media">
        <div className="kodza-steps__frame">
          <img className="kodza-steps__image" src="https://kodza.dev/media/kz-steps-1400.webp" alt="" />
          {' '}
          <img className="kodza-steps__image" src="https://kodza.dev/media/kz-block-1400.webp" alt="" />
          {' '}
          <img className="kodza-steps__image" src="https://kodza.dev/media/kz-stack-1400.webp" alt="" />
          {' '}
          <img className="kodza-steps__image" src="https://kodza.dev/media/kz-float-1400.webp" alt="" />
          <p className="kodza-steps__counter" aria-hidden="true">
            <span className="kodza-steps__num">01</span>
            {' '}
            <span className="kodza-steps__total">/ 04</span>
            {' '}
            <span className="kodza-steps__bars" />
          </p>
        </div>
      </div>
      <ol className="kodza-steps__list">
        <li className="kodza-steps__step">
          <p className="kodza-steps__index">01</p>
          <h2 className="kodza-steps__title">Find it</h2>
          <p className="kodza-steps__text">Search, filter, or scroll the catalogue like it is 2009 and you have all afternoon.</p>
        </li>
        <li className="kodza-steps__step">
          <p className="kodza-steps__index">02</p>
          <h2 className="kodza-steps__title">Copy it</h2>
          <p className="kodza-steps__text">Three tabs, one button. The clipboard does the heavy lifting, as it should.</p>
        </li>
        <li className="kodza-steps__step">
          <p className="kodza-steps__index">03</p>
          <h2 className="kodza-steps__title">Paste it</h2>
          <p className="kodza-steps__text">WordPress, Webflow, a page written by hand in 2014. It does not ask where it is.</p>
        </li>
        <li className="kodza-steps__step">
          <p className="kodza-steps__index">04</p>
          <h2 className="kodza-steps__title">Ship it</h2>
          <p className="kodza-steps__text">Push to production. On a Friday, if you must. We will not tell anyone.</p>
        </li>
      </ol>
    </section>
  );
}

Checked

Checked before you paste.

Robots poked at it before you did. Every component goes through the same checks, and again each time it changes.

What ranLast run Oct 19, 2026

Accessibilityaxe-core 4.10.2: the WCAG 2.1 A and AA rules, plus best practices. 0 issues

KeyboardThe Tab key gets there, and the focus ring shows when it does. Passed

Reduced motionTurn on reduced motion and what moved just appears. Nothing loops. Passed

Light and darkThe same checks on both themes, contrast included. Passed

WordPressPasted into Twenty Twenty-Five, Twenty Twenty-One, Astra, Blocksy, GeneratePress, Hello Elementor, Kadence and OceanWP. Nothing to flag. 8 / 8 themes

Robots checked this. A human with VoiceOver hasn't yet.