Step Progress
A copy-paste progress component in pure HTML & CSS. Zero dependencies, framework-agnostic, MIT-licensed.
ProgressHTMLCSSany framework
Copy into your project
HTML
<!-- Step Progress (4 steps, currently on step 2) -->
<div class="nuda-step-progress" role="progressbar"
aria-valuenow="2" aria-valuemin="1" aria-valuemax="4"
aria-label="Step 2 of 4">
<span class="nuda-step-progress__dot nuda-step-progress__dot--done"></span>
<span class="nuda-step-progress__line nuda-step-progress__line--done"></span>
<span class="nuda-step-progress__dot nuda-step-progress__dot--active"></span>
<span class="nuda-step-progress__line"></span>
<span class="nuda-step-progress__dot"></span>
<span class="nuda-step-progress__line"></span>
<span class="nuda-step-progress__dot"></span>
</div>CSS
/* Step Progress
Step-by-step progress indicator with dots and connecting lines.
Add --done and --active modifiers to control state.
Customize: --step-color, --step-track */
.nuda-step-progress {
--step-color: #818cf8;
--step-track: rgba(255, 255, 255, 0.15);
display: flex;
align-items: center;
gap: 0;
}
.nuda-step-progress__dot {
width: 14px;
height: 14px;
border-radius: 50%;
background: var(--step-track);
border: 2px solid rgba(255, 255, 255, 0.2);
flex-shrink: 0;
transition: all 0.3s ease;
}
.nuda-step-progress__dot--done {
background: var(--step-color);
border-color: var(--step-color);
}
.nuda-step-progress__dot--active {
background: var(--step-color);
border-color: var(--step-color);
box-shadow: 0 0 0 4px rgba(129, 140, 248, 0.3);
animation: nuda-step-pulse 1.5s ease-in-out infinite;
}
.nuda-step-progress__line {
width: 32px;
height: 2px;
background: var(--step-track);
flex-shrink: 0;
transition: background 0.3s ease;
}
.nuda-step-progress__line--done {
background: var(--step-color);
}
@keyframes nuda-step-pulse {
0%, 100% {
box-shadow: 0 0 0 4px rgba(129, 140, 248, 0.3);
}
50% {
box-shadow: 0 0 0 8px rgba(129, 140, 248, 0);
}
}
@media (prefers-reduced-motion: reduce) {
.nuda-step-progress__dot--active {
animation: none;
box-shadow: 0 0 0 4px rgba(129, 140, 248, 0.3);
}
}How to use Step Progress
Paste the HTML where you need it and the CSS into a global stylesheet (or a <style> tag). Every class is prefixed nuda- so it never collides with Tailwind or your own styles. Tweak the CSS custom properties to match your design system.
Works in React, Vue, Svelte, Astro, Next.js, Nuxt, Laravel Blade, Django, Rails — or a single .html file. No npm install, no build step.