04.12 · Micro-Interactions

Progress Animation

A bar, a ring and steps fill up to show progress. Best for uploads.

Watch it

It plays by itself. Turn on slow motion to see each part of the movement.

Try it

Change a setting and the animation plays again.

Fills to

How far the progress goes in one play.

Speed

How long the fill takes.

Feel

Smooth starts fast and eases into the end.

More optionsFewer options

For waits of unknown length: the bar slides instead.

Fill color

The color of the bar, the ring and the steps.

Copy the prompt

Paste it into an AI assistant such as ChatGPT, Claude or Cursor to build this in your own project.

Add a progress indicator to [the upload, download or task whose progress you know]. Show how much is done with a bar that fills from left to right, a ring whose outline fills around the circle, or a row of steps that light up in turn, all driven by the same percentage and shown with the number. Fill it smoothly as progress arrives, and only show real progress: never race to near the end and stall. When the settings ask for it, slide a short piece along the bar for waits of unknown length. If the visitor has reduced motion turned on, jump straight to the current value. Match the settings listed below.

Replace the words in brackets with your own element. Your settings are added at the end.

Free and open source. If this helped, a star on GitHub helps other people find it.

Star on GitHub

What it is

The full explanation is in README.md.

Good for

  • Uploads
  • Downloads
  • Multi-step forms
  • Installs

Avoid on

  • Unknown waits
  • Fake progress