Back to the library

Waypoint stepper

Variant: Linear

This is the same four-step progress ring, moving at a constant speed with no acceleration. Use it for system-driven progress, such as an import or a batch job moving through stages on its own. The steady pace suggests a machine at work rather than a reply to a person. The node fills still ease in, so the moves look mechanical but arrivals don't look abrupt.

stepperprogresswizardautomatedstate-change

The source

A complete HTML document. Paste it into an empty .html file and it plays — no stylesheet, script, font, or image to fetch.

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Waypoint stepper — linear</title>
<style>
:root {
  /* Neutrals — fixed, never remixed. */
  --ivory: #faf9f5;
  --paper: #ffffff;
  --oat: #e3dacc;
  --slate: #141413;

  /* Knobs — the remix API. A knob exists iff declared here and used below. */
  --hue: 38.8;
  --lift: 0;
  --chroma: 1;
  --round: 1;
  --speed: 1;

  /* Accents — derived from the knobs with the family's offsets baked in,
     so one hue roll moves them together. Defaults reproduce the original hex
     (#d97757 / #b85c3e / #788c5d / #b04a3f). */
  --clay: oklch(calc(0.6724 + var(--lift)) calc(0.1308 * var(--chroma)) var(--hue));
  --clay-d: oklch(calc(0.5797 + var(--lift)) calc(0.127 * var(--chroma)) var(--hue));
  --olive: oklch(calc(0.6118 + var(--lift)) calc(0.0713 * var(--chroma)) calc(var(--hue) + 88.3));
  --rust: oklch(calc(0.5408 + var(--lift)) calc(0.1357 * var(--chroma)) calc(var(--hue) - 10.3));

  /* Clock — every duration in the document runs off --t. */
  --cycle: 5s;
  --t: calc(var(--cycle) / var(--speed));

  --ease-out: cubic-bezier(0.23, 1, 0.32, 1);
}

*, *::before, *::after { box-sizing: border-box; }

body {
  margin: 0;
  min-height: 100vh;
  display: grid;
  place-items: center;
  background: var(--ivory);
  color: var(--slate);
  font-family: system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif;
}

.card {
  width: min(420px, 92vw);
  background: var(--paper);
  border: 1px solid var(--oat);
  border-radius: calc(14px * var(--round));
  padding: clamp(18px, 5vw, 28px) clamp(14px, 4vw, 24px) clamp(18px, 5vw, 26px);
}

.eyebrow {
  margin: 0;
  font-size: clamp(11px, 2.8vw, 12px);
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--clay-d);
}

.title {
  margin: 4px 0 clamp(16px, 5vw, 24px);
  font-size: clamp(17px, 4.6vw, 20px);
  font-weight: 600;
  letter-spacing: -0.01em;
}

.stepper { position: relative; }

/* Rail and track both span node 1's centre to node 4's centre (12.5% inset). */
.rail {
  position: absolute;
  left: 12.5%;
  right: 12.5%;
  top: 13px;
  height: 2px;
  background: var(--oat);
  border-radius: 999px;
  overflow: hidden;
}

.fill-fade {
  position: absolute;
  inset: 0;
  animation: reset-fade var(--t) var(--ease-out) infinite;
}

.fill {
  position: absolute;
  inset: 0;
  background: var(--clay-d);
  transform-origin: left center;
  transform: scaleX(0);
  animation: advance-fill var(--t) linear infinite;
}

.steps {
  position: relative;
  z-index: 1;
  display: grid;
  grid-template-columns: repeat(4, 1fr);
  margin: 0;
  padding: 0;
  list-style: none;
}

.step,
.lit {
  display: grid;
  grid-template-rows: 28px auto;
  justify-items: center;
  align-items: center;
  row-gap: 6px;
}

.step { position: relative; }

.lit {
  position: absolute;
  inset: 0;
  opacity: 0;
}

.dot {
  width: 12px;
  height: 12px;
  border-radius: 50%;
  background: var(--paper);
  border: 2px solid var(--oat);
}

.dot--on {
  background: var(--clay-d);
  border-color: var(--clay-d);
}

.label {
  font-size: clamp(12px, 3.3vw, 14px);
  white-space: nowrap;
  opacity: 0.5;
}

.label--on { opacity: 1; }

.s0 .lit { animation: reset-fade var(--t) var(--ease-out) infinite; }
.s1 .lit { animation: reach-1 var(--t) var(--ease-out) infinite; }
.s2 .lit { animation: reach-2 var(--t) var(--ease-out) infinite; }
.s3 .lit { animation: reach-3 var(--t) var(--ease-out) infinite; }

.track {
  position: absolute;
  z-index: 2;
  left: 12.5%;
  right: 12.5%;
  top: 0;
  height: 28px;
  container-type: inline-size;
  pointer-events: none;
}

.carriage {
  position: absolute;
  left: 0;
  top: 0;
  width: 0;
  height: 100%;
  animation: advance var(--t) linear infinite;
}

.marker {
  position: absolute;
  left: -12px;
  top: 2px;
  width: 24px;
  height: 24px;
  border-radius: 50%;
  border: 2px solid var(--clay);
  box-shadow: 0 0 0 4px color-mix(in oklch, var(--clay) 18%, transparent);
  animation: reset-fade var(--t) var(--ease-out) infinite;
}

/* Three 300ms moves with long holds between them. At the end the progress fades out
   and the ring reappears at step one, so it never makes a long backward trip. */
@keyframes advance {
  0%, 14%  { transform: translateX(0); }
  20%, 40% { transform: translateX(33.333cqw); }
  46%, 66% { transform: translateX(66.667cqw); }
  72%, 90% { transform: translateX(100cqw); }
  91%, 100% { transform: translateX(0); }
}

@keyframes advance-fill {
  0%, 14%  { transform: scaleX(0); }
  20%, 40% { transform: scaleX(0.33333); }
  46%, 66% { transform: scaleX(0.66667); }
  72%, 90% { transform: scaleX(1); }
  91%, 100% { transform: scaleX(0); }
}

/* Fade-out (200ms) is quicker than fade-in (300ms). */
@keyframes reset-fade {
  0%, 86%  { opacity: 1; }
  90%, 92% { opacity: 0; }
  98%, 100% { opacity: 1; }
}

@keyframes reach-1 {
  0%, 18%  { opacity: 0; }
  22%, 86% { opacity: 1; }
  90%, 100% { opacity: 0; }
}

@keyframes reach-2 {
  0%, 44%  { opacity: 0; }
  48%, 86% { opacity: 1; }
  90%, 100% { opacity: 0; }
}

@keyframes reach-3 {
  0%, 70%  { opacity: 0; }
  74%, 86% { opacity: 1; }
  90%, 100% { opacity: 0; }
}

@media (max-width: 380px) {
  .card { padding: 16px 10px 18px; }
  .eyebrow, .title { padding-left: 6px; }
  .label { font-size: 12px; }
}

@media (prefers-reduced-motion: reduce) {
  .track,
  .fill-fade { display: none; }
  .s0 .lit,
  .s1 .lit,
  .s2 .lit,
  .s3 .lit { animation-duration: calc(var(--t) * 2); }
}
</style>
</head>
<body>
  <div class="card">
    <p class="eyebrow">New policy</p>
    <p class="title">Guided setup</p>
    <div class="stepper">
      <span class="rail" aria-hidden="true"><span class="fill-fade"><span class="fill"></span></span></span>
      <ol class="steps" aria-label="Setup progress">
        <li class="step s0"><span class="dot"></span><span class="label">Details</span><span class="lit" aria-hidden="true"><span class="dot dot--on"></span><span class="label label--on">Details</span></span></li>
        <li class="step s1"><span class="dot"></span><span class="label">Review</span><span class="lit" aria-hidden="true"><span class="dot dot--on"></span><span class="label label--on">Review</span></span></li>
        <li class="step s2"><span class="dot"></span><span class="label">Sign</span><span class="lit" aria-hidden="true"><span class="dot dot--on"></span><span class="label label--on">Sign</span></span></li>
        <li class="step s3"><span class="dot"></span><span class="label">Submit</span><span class="lit" aria-hidden="true"><span class="dot dot--on"></span><span class="label label--on">Submit</span></span></li>
      </ol>
      <div class="track" aria-hidden="true"><div class="carriage"><span class="marker"></span></div></div>
    </div>
  </div>
</body>
</html>

The variant family

Same idea, one axis moved. Compare them side by side before you commit.