Components→Cursor Trail

Cursor Trail

Decorative cursor trail with staggered spring decay. Dots follow the cursor with increasing delay, creating a comet-tail effect with independent springs.

Animation

Move your cursor around

Watch the particles follow your movement with physics simulation.

Installation

Copy and paste

Copy the component source code and paste it into your project.

import { CursorTrail } from "driftkit";

Props

Name	Type	Required	Description
`count`	`number`	No	Number of trail dots.
`size`	`number`	No	Base dot size in pixels.
`color`	`string`	No	Dot color. currentColor = rainbow gradient.

🎮

Playground

Tune spring physics for this component

Live Preview

Cursor Trail Component

Spring Physics

StiffnessiHow quickly the animation reaches its target. Higher values create snappier animations.300

DampingiHow much the animation resists motion. Lower values create more bounce and overshoot.30

MassiHow heavy the element feels during animation. Higher values make animations slower with more momentum.1

Generated Code

const springConfig = {
  "type": "spring",
  "stiffness": 300,
  "damping": 30,
  "mass": 1
};

// Basic hover animation
<motion.div
  whileHover={{ scale: 1.05 }}
  whileTap={{ scale: 0.95 }}
  transition={springConfig}
>
  <CursorTrail />
</motion.div>

// Advanced with custom animations
<motion.div
  animate={{ 
    scale: [1, 1.02, 1],
    y: [0, -4, 0]
  }}
  transition={{
    ...springConfig,
    repeat: Infinity,
    repeatDelay: 2
  }}
>
  <CursorTrail />
</motion.div>

Stiffness: Controls animation speed. Higher values create snappier animations.

Damping: Controls resistance to motion. Lower values create more bounce and overshoot.

Mass: Controls the perceived weight. Higher values make animations slower with more momentum.

Source Code

View the source code on GitHub to see the full implementation.

View on GitHub