Grid loader
Diagonal flow
A broad diagonal band smoothly brightens and fades across fixed square cells. A single React component with its CSS built in and no dependencies. Install it with the shadcn CLI or copy the source.
Preview and installation
Run this command in any project set up with shadcn.
npx shadcn@latest add https://loadercn.vercel.app/r/grid-diagonal-flow.jsonAdded the @loadercn registry? Use the short form:
npx shadcn@latest add @loadercn/grid-diagonal-flowThen add it to your interface:
import { GridDiagonalFlow } from "@/components/ui/grid-diagonal-flow"
<GridDiagonalFlow size={48} speed={1.6} />Inherits text color. Accepts className, style, and a custom loading label. Respects reduced-motion preferences.
import type { CSSProperties, ComponentProps } from "react"
export type GridDiagonalFlowProps = ComponentProps<"span"> & {
size?: number
/** Duration of one complete cycle, in seconds. */
speed?: number
label?: string
}
export function GridDiagonalFlow({
size = 40,
speed = 1.6,
label = "Loading",
className,
style,
...props
}: GridDiagonalFlowProps) {
return (
<span
role="status"
aria-label={label}
{...props}
className={["grid-diagonal-flow-loader", className]
.filter(Boolean)
.join(" ")}
style={
{
width: size,
height: size,
"--loader-duration": `${Math.max(0.1, speed)}s`,
...style,
} as CSSProperties
}
>
<span aria-hidden="true" className="grid-diagonal-flow-loader-grid">
{/* Equal row + column values share a phase, lighting a whole diagonal. */}
{Array.from({ length: 16 }, (_, i) => (
<span
key={i}
style={{
animationDelay: `${((Math.floor(i / 4) + (i % 4)) / 8 - 1) * Math.max(0.1, speed)}s`,
}}
/>
))}
</span>
<style>{`
.grid-diagonal-flow-loader { display: inline-flex; flex-shrink: 0; }
.grid-diagonal-flow-loader-grid { display: grid; width: 100%; height: 100%; grid-template-columns: repeat(4, 1fr); grid-template-rows: repeat(4, 1fr); gap: 8%; }
.grid-diagonal-flow-loader-grid > span { background: currentColor; border-radius: 0; opacity: .14; animation: grid-diagonal-flow-loader-light var(--loader-duration) ease-in-out infinite; }
@keyframes grid-diagonal-flow-loader-light { 0%, 100% { opacity: .14; } 50% { opacity: 1; } }
@media (prefers-reduced-motion: reduce) { .grid-diagonal-flow-loader-grid > span { animation: none; opacity: .65; } }
`}</style>
</span>
)
}
Copy the complete file into your components directory. Styles are included.
When to use it
The smoothest of the scans. Choose it for polished, brand-forward screens such as splash screens or onboarding steps.
Props
Diagonal flow accepts size, speed, label, className, and style, like every loader in the collection. See the installation guide for the full reference.