An animated cursor component that allows you to customize both the cursor and cursor follow elements with smooth animations.
Made by Léo · Credits: imskyleenInstallation
Usage
API Reference
CursorProvider
| Prop | Type | Default | Description |
|---|---|---|---|
children | React.ReactNode | - | The children of the CursorProvider |
global? | boolean | false | Whether the cursor is global |
...props? | HTMLMotionProps<"div"> | - | The props of the CursorContainer |
Cursor
| Prop | Type | Default | Description |
|---|---|---|---|
asChild? | boolean | false | Change the default rendered element for the one passed as a child, merging their props and behavior. |
...props? | HTMLMotionProps<"div"> | - | The props of the CursorContainer |
CursorFollow
| Prop | Type | Default | Description |
|---|---|---|---|
asChild? | boolean | false | Change the default rendered element for the one passed as a child, merging their props and behavior. |
side? | CursorFollowSide | bottom | The side of the CursorFollow |
sideOffset? | number | 15 | The side offset of the CursorFollow |
align? | CursorFollowAlign | end | The align of the CursorFollow |
alignOffset? | number | 5 | The align offset of the CursorFollow |
transition? | SpringOptions | { stiffness: 500, damping: 50, bounce: 0 } | The transition of the CursorFollow |
...props? | HTMLMotionProps<"div"> | - | The props of the CursorFollow |
Built by Léo
Last updated: 5/14/2026