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.