Skip to content

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.

More progress components

← Browse all NudaUI components