State & Feedback Animation — Reference
Content Shimmer Wave
The Content Shimmer Wave is a pure-CSS loading animation that a full-width shimmer wave overlay that sweeps across a container with a translucent highlight band. Ideal for hero sections, image placeholders, or large content blocks that are still loading. 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 Content Shimmer Wave
- 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
- 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+)
- Typically under 2 KB of CSS — negligible impact on Largest Contentful Paint (LCP)
How it compares
Unlike JavaScript spinners rendered with requestAnimationFrame loops, the Content Shimmer Wave 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
.box { width: 240px; height: 120px; background: #1c1c1e; border-radius: 8px; position: relative; overflow: hidden; }
.box::after { content: ''; position: absolute; inset: 0; background: linear-gradient(110deg, transparent 10%, rgba(255,255,255,0.08) 10%, rgba(255,255,255,0.08) 35%, transparent 35%); animation: wave 1.8s ease-in-out infinite; }
@keyframes wave { 0%{transform: translateX(-100%)} 100%{transform: translateX(100%)} }
body { margin: 0; min-height: 100vh; display: flex; align-items: center; justify-content: center; background: #0f0f0f; }HTML
<div class="box"></div>Full source
<!DOCTYPE html>
<html><head><style>
.box { width: 240px; height: 120px; background: #1c1c1e; border-radius: 8px; position: relative; overflow: hidden; }
.box::after { content: ''; position: absolute; inset: 0; background: linear-gradient(110deg, transparent 10%, rgba(255,255,255,0.08) 10%, rgba(255,255,255,0.08) 35%, transparent 35%); animation: wave 1.8s ease-in-out infinite; }
@keyframes wave { 0%{transform: translateX(-100%)} 100%{transform: translateX(100%)} }
body { margin: 0; min-height: 100vh; display: flex; align-items: center; justify-content: center; background: #0f0f0f; }
</style></head><body><div class="box"></div></body></html>Frequently asked questions
How do I add the Content Shimmer Wave 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/content-shimmer-wave.
Is the Content Shimmer Wave 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 Content Shimmer Wave work on mobile browsers?
Yes. The Content Shimmer Wave 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 Content Shimmer Wave's colors, speed, or size?
Yes. Open the live customization workspace at grepped.dev/animations/state-feedback/content-shimmer-wave 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