Back to the library
Waypoint stepper
Variant: In-out
A progress ring moves from step to step in a four-step setup flow. Each step it passes stays filled, so finished steps remain visible. Use it in wizards and checkout flows where people need to see where they are and what's left. Each move is an on-screen move, so the ring uses the standard ease-in-out: it leaves its node gradually, covers most of the distance mid-move and settles on the next node without overshooting.
stepperprogresswizardstate-changeonboarding
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 — in-out</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);
--ease-in-out: cubic-bezier(0.77, 0, 0.175, 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) var(--ease-in-out) 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) var(--ease-in-out) 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.