Animated Path Background
Animated Path Background is a React and Tailwind CSS background component from Kokonut UI, licensed MIT. Copy it and paste it into your project.
Kokonut UI
MIT
backgrounds
What it is
Animated Path Background is a React and Tailwind CSS background component from Kokonut UI, licensed MIT. Copy it and paste it into your project.
How to use it
Open it in the catalogue, press copy, and paste it into your project. The prompt you copy carries the code and the rules that tell your agent to reproduce it without changing anything.
Five free copies a month. No card.
Needs
npm i motion
Licence
This component comes from Kokonut UI and is redistributed under the MIT licence, which permits commercial use. The copyright notice travels with the code.
Animated Path Background
"use client";
/**
* @author: @dorianbaffier
* @description: Background Paths
* @version: 1.0.0
* @date: 2025-06-26
* @license: MIT
* @website: https://kokonutui.com
* @github: https://github.com/kokonut-labs/kokonutui
*/
import { motion } from "motion/react";
import { memo, useMemo } from "react";
interface Point {
x: number;
y: number;
}
interface PathData {
id: string;
d: string;
opacity: number;
width: number;
duration: number;
delay: number;
}
// Path generation function
function generateAestheticPath(
index: number,
position: number,
type: "primary" | "secondary" | "accent"
): string {
const baseAmplitude =
type === "primary" ? 150 : type === "secondary" ? 100 : 60;
const phase = index * 0.2;
const points: Point[] = [];
const segments = type === "primary" ? 10 : type === "secondary" ? 8 : 6;
const startX = 2400;
const startY = 800;
const endX = -2400;
const endY = -800 + index * 25;
for (let i = 0; i <= segments; i++) {
const progress = i / segments;
const eased = 1 - (1 - progress) ** 2;
const baseX = startX + (endX - startX) * eased;
const baseY = startY + (endY - startY) * eased;
const amplitudeFactor = 1 - eased * 0.3;
const wave1 =
Math.sin(progress * Math.PI * 3 + phase) *
(baseAmplitude * 0.7 * amplitudeFactor);
const wave2 =
Math.cos(progress * Math.PI * 4 + phase) *
(baseAmplitude * 0.3 * amplitudeFactor);
const wave3 =
Math.sin(progress * Math.PI * 2 + phase) *
(baseAmplitude * 0.2 * amplitudeFactor);
points.push({
x: baseX * position,
y: baseY + wave1 + wave2 + wave3,
});
}
const pathCommands = points.map((point: Point, i: number) => {
if (i === 0) return `M ${point.x} ${point.y}`;
const prevPoint = points[i - 1];
const tension = 0.4;
const cp1x = prevPoint.x + (point.x - prevPoint.x) * tension;
const cp1y = prevPoint.y;
const cp2x = prevPoint.x + (point.x - prevPoint.x) * (1 - tension);
const cp2y = point.y;
return `C ${cp1x} ${cp1y}, ${cp2x} ${cp2y}, ${point.x} ${point.y}`;
});
return pathCommands.join(" ");
}
const generateUniqueId = (prefix: string): string =>
`${prefix}-${Math.random().toString(36).substr(2, 9)}`;
// Memoized FloatingPaths component
const FloatingPaths = memo(function FloatingPaths({
position,
}: {
position: number;
}) {
// Increased number of paths while maintaining optimization
const primaryPaths: PathData[] = useMemo(
() =>
Array.from({ length: 12 }, (_, i) => ({
id: generateUniqueId("primary"),
d: generateAestheticPath(i, position, "primary"),
opacity: 0.15 + i * 0.02,
width: 4 + i * 0.3,
duration: 25,
delay: 0,
})),
[position]
);
const secondaryPaths: PathData[] = useMemo(
() =>
Array.from({ length: 15 }, (_, i) => ({
id: generateUniqueId("secondary"),
d: generateAestheticPath(i, position, "secondary"),
opacity: 0.12 + i * 0.015,
width: 3 + i * 0.25,
duration: 20,
delay: 0,
})),
[position]
);
const accentPaths: PathData[] = useMemo(
() =>
Array.from({ length: 10 }, (_, i) => ({
id: generateUniqueId("accent"),
d: generateAestheticPath(i, position, "accent"),
opacity: 0.08 + i * 0.12,
width: 2 + i * 0.2,
duration: 15,
delay: 0,
})),
[position]
);
// Shared animation configuration
const sharedAnimationProps = {
opacity: 1,
scale: 1,
transition: {
opacity: { duration: 1 },
scale: { duration: 1 },
},
};
return (
<div className="pointer-events-none absolute inset-0 overflow-hidden">
<svg
className="h-full w-full text-slate-950/40 dark:text-white/40"
fill="none"
preserveAspectRatio="xMidYMid slice"
viewBox="-2400 -800 4800 1600"
>
<title>Background Paths</title>
<defs>
<linearGradient id="sharedGradient" x1="0%" x2="100%" y1="0%" y2="0%">
<stop offset="0%" stopColor="rgba(147, 51, 234, 0.5)" />
<stop offset="50%" stopColor="rgba(236, 72, 153, 0.5)" />
<stop offset="100%" stopColor="rgba(59, 130, 246, 0.5)" />
</linearGradient>
</defs>
<g className="primary-waves">
{primaryPaths.map((path) => (
<motion.path
animate={{
...sharedAnimationProps,
y: [0, -15, 0],
}}
d={path.d}
initial={{ opacity: 0, scale: 0.8 }}
key={path.id}
stroke="url(#sharedGradient)"
strokeLinecap="round"
strokeWidth={path.width}
style={{ opacity: path.opacity }}
transition={{
...sharedAnimationProps.transition,
y: {
duration: 8,
repeat: Number.POSITIVE_INFINITY,
ease: "easeInOut",
repeatType: "reverse",
},
}}
/>
))}
</g>
<g className="secondary-waves" style={{ opacity: 0.8 }}>
{secondaryPaths.map((path) => (
<motion.path
animate={{
...sharedAnimationProps,
y: [0, -10, 0],
}}
d={path.d}
initial={{ opacity: 0, scale: 0.9 }}
key={path.id}
stroke="url(#sharedGradient)"
strokeLinecap="round"
strokeWidth={path.width}
style={{ opacity: path.opacity }}
transition={{
...sharedAnimationProps.transition,
y: {
duration: 6,
repeat: Number.POSITIVE_INFINITY,
ease: "easeInOut",
repeatType: "reverse",
},
}}
/>
))}
</g>
<g className="accent-waves" style={{ opacity: 0.6 }}>
{accentPaths.map((path) => (
<motion.path
animate={{
...sharedAnimationProps,
y: [0, -5, 0],
}}
d={path.d}
initial={{ opacity: 0, scale: 0.95 }}
key={path.id}
stroke="url(#sharedGradient)"
strokeLinecap="round"
strokeWidth={path.width}
style={{ opacity: path.opacity }}
transition={{
...sharedAnimationProps.transition,
y: {
duration: 4,
repeat: Number.POSITIVE_INFINITY,
ease: "easeInOut",
repeatType: "reverse",
},
}}
/>
))}
</g>
</svg>
</div>
);
});
// Memoized AnimatedTitle component
const AnimatedTitle = memo(function AnimatedTitle({
title,
}: {
title: string;
}) {
return (
<motion.h1
animate={{ opacity: 1, y: 0 }}
className="mb-8 bg-gradient-to-r from-neutral-800/90 to-neutral-600/90 bg-clip-text font-bold text-3xl text-transparent tracking-tighter sm:text-5xl md:text-5xl dark:from-white/90 dark:to-white/70"
initial={{ opacity: 0, y: 20 }}
transition={{
duration: 1.2,
ease: [0.2, 0.65, 0.3, 0.9],
}}
>
{title}
</motion.h1>
);
});
export default memo(function BackgroundPaths({
title = "Background Paths",
}: {
title?: string;
}) {
return (
<div className="relative flex min-h-screen w-full items-center justify-center overflow-hidden bg-white dark:bg-neutral-950">
<div className="absolute inset-0">
<FloatingPaths position={1} />
</div>
<div className="container relative z-10 mx-auto px-4 text-center md:px-6">
<motion.div
animate={{ opacity: 1 }}
className="mx-auto max-w-4xl"
initial={{ opacity: 0 }}
transition={{ duration: 2 }}
>
<AnimatedTitle title={title} />
</motion.div>
</div>
</div>
);
});