Spinners Animation — Reference

Whirl

The Whirl is a CSS animation component that a pure CSS whirl spinner where a single ball simultaneously scales, rotates over 2000 degrees, and arcs vertically — all in one seamless infinite loop. It ships as self-contained HTML and CSS with no external dependencies, making it drop-in ready for any modern web project regardless of framework or build system.

spinnerwhirlloaderrotatescale

Customize in Workspace View Live Preview →

When to use the Whirl

Async form submissions and API fetch indicators
Content loading placeholders in data-heavy dashboards
Component libraries and design systems that need consistent motion patterns
Progressive enhancement — works in all modern browsers, degrades gracefully

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+)
Self-contained in a single HTML file — no npm install, no build step, paste and ship

How it compares

Unlike equivalent JavaScript implementations, the Whirl does not require any runtime library — there is nothing to install, bundle, or load asynchronously.

Compared to animated GIFs or video embeds, this CSS component is resolution-independent, theme-able via CSS custom properties, and weighs a fraction of the equivalent media file.

Source code

CSS

css

body { margin: 0; min-height: 100vh; display: flex; align-items: center; justify-content: center; background: #0f0f0f; }
    :root { --primary: #6366f1; }

    .whirl {
      display: flex;
      align-items: center;
      justify-content: center;
      position: relative;
      height: 80px;
      width: 80px;
    }

    .whirl:before {
      animation: whirl 2s infinite linear;
      background-color: var(--primary);
      border-radius: 100%;
      content: '';
      height: 30px;
      width: 30px;
    }

    @keyframes whirl {
      0%   { transform: scale(0)    rotate(-45deg)  translateY(0); }
      50%  { transform: scale(1.25) rotate(960deg)  translateY(100%); }
      100% { transform: scale(0)    rotate(2000deg) translateY(0); }
    }

HTML

html

<div class="whirl"></div>

Full source

html

<!DOCTYPE html>
<html>
<head>
  <style>
    body { margin: 0; min-height: 100vh; display: flex; align-items: center; justify-content: center; background: #0f0f0f; }
    :root { --primary: #6366f1; }

    .whirl {
      display: flex;
      align-items: center;
      justify-content: center;
      position: relative;
      height: 80px;
      width: 80px;
    }

    .whirl:before {
      animation: whirl 2s infinite linear;
      background-color: var(--primary);
      border-radius: 100%;
      content: '';
      height: 30px;
      width: 30px;
    }

    @keyframes whirl {
      0%   { transform: scale(0)    rotate(-45deg)  translateY(0); }
      50%  { transform: scale(1.25) rotate(960deg)  translateY(100%); }
      100% { transform: scale(0)    rotate(2000deg) translateY(0); }
    }
  </style>
</head>
<body>
  <div class="whirl"></div>
</body>
</html>

Frequently asked questions

How do I add the Whirl 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/spinners/whirl-spinner.

Is the Whirl 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 Whirl work on mobile browsers?

Yes. The Whirl 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 Whirl's colors, speed, or size?

Yes. Open the live customization workspace at grepped.dev/animations/spinners/whirl-spinner 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