State & Feedback Animation — Reference
Circular Progress
The Circular Progress is a pure-CSS loading animation that a circular progress ring that smoothly fills to a target percentage using SVG stroke-dashoffset. Use it for profile completion meters, download indicators, or any percentage-based metric. It requires no JavaScript, runs entirely on the GPU via CSS transforms, and communicates application state clearly without blocking the browser's main thread.
When to use the Circular Progress
- File upload and multi-step form completion feedback
- Communicating async operations like API fetches or file uploads
- Replacing blank screens during server-side rendering hydration
- Inline loading states within tables, feeds, or infinite-scroll lists
Performance characteristics
- GPU-accelerated — uses CSS transform and opacity so compositing happens off the main thread
- Zero JavaScript dependency in most configurations — no framework, no bundler required
- Approximately 60 fps on any device that supports CSS animations (Chrome 43+, Firefox 16+, Safari 9+)
- Typically under 2 KB of CSS — negligible impact on Largest Contentful Paint (LCP)
How it compares
Unlike JavaScript spinners rendered with requestAnimationFrame loops, the Circular Progress runs on the GPU compositor thread, meaning a blocked main thread — caused by heavy data processing or framework hydration — will not freeze or jank the animation.
Compared to GIF loading indicators, this CSS approach uses roughly 95% less bandwidth and scales crisp at every pixel density, including HiDPI and Retina displays.
Source code
CSS
.circle { width: 80px; height: 80px; position: relative; }
.circle svg { transform: rotate(-90deg); }
.circle .bg { fill: none; stroke: #27272a; stroke-width: 6; }
.circle .fill { fill: none; stroke: #22c55e; stroke-width: 6; stroke-linecap: round; stroke-dasharray: 263.89378290154264; stroke-dashoffset: 263.89378290154264; animation: ease 1.5s ease-out forwards; }
@keyframes ease { to { stroke-dashoffset: 79.16813487046281; } }
body { margin: 0; min-height: 100vh; display: flex; align-items: center; justify-content: center; background: #0f0f0f; }HTML
<div class="circle"><svg width="80" height="80" viewBox="0 0 100 100"><circle class="bg" cx="50" cy="50" r="42"/><circle class="fill" cx="50" cy="50" r="42"/></svg></div>Full source
<!DOCTYPE html>
<html><head><style>
.circle { width: 80px; height: 80px; position: relative; }
.circle svg { transform: rotate(-90deg); }
.circle .bg { fill: none; stroke: #27272a; stroke-width: 6; }
.circle .fill { fill: none; stroke: #22c55e; stroke-width: 6; stroke-linecap: round; stroke-dasharray: 263.89378290154264; stroke-dashoffset: 263.89378290154264; animation: ease 1.5s ease-out forwards; }
@keyframes ease { to { stroke-dashoffset: 79.16813487046281; } }
body { margin: 0; min-height: 100vh; display: flex; align-items: center; justify-content: center; background: #0f0f0f; }
</style></head><body>
<div class="circle"><svg width="80" height="80" viewBox="0 0 100 100"><circle class="bg" cx="50" cy="50" r="42"/><circle class="fill" cx="50" cy="50" r="42"/></svg></div>
</body></html>Frequently asked questions
How do I add the Circular Progress to my project?
Copy the full source code from the code block on this page. Paste the <style> block into your stylesheet (or a <style> tag in your HTML head) and the HTML markup into your template. No npm install or build step is required — the animation is self-contained. To customize colors, speed, or size, use Grepped's workspace at grepped.dev/animations/state-feedback/circular-progress.
Is the Circular Progress free to use?
Yes. All Grepped preset animations are free to use in personal and commercial projects. You may copy, modify, and redistribute the code without attribution. The only limitation is that you may not resell the presets themselves as part of a competing animation library.
Does the Circular Progress work on mobile browsers?
Yes. The Circular Progress uses standard CSS animations and transforms that are supported in all modern mobile browsers — Chrome for Android, Safari on iOS 9+, Samsung Internet, and Firefox for Android. Where JavaScript is used for interactivity (e.g. cursor effects), it falls back gracefully on touch devices.
Can I customize the Circular Progress's colors, speed, or size?
Yes. Open the live customization workspace at grepped.dev/animations/state-feedback/circular-progress to adjust the animation with real-time sliders, color pickers, and toggles — no code required. For deeper changes, the source code uses CSS custom properties (variables) so you can edit them directly in your stylesheet.
Want to customize this animation or generate a new one from a text prompt?
Open in Workspace — it's free