
Full Screen Crosshair
Cursor
Make the page respond to pointer position with animated text, coordinates, or visual feedback that feels reactive without taking over.
Cursor Move turns pointer position into visible feedback. The page reacts like it knows exactly where the visitor is.
Use Cursor Move when a homepage, demo page, or experimental section wants pointer tracking to be part of the interaction layer. The page job is responsiveness: cursor movement should feel connected to text, coordinates, or visual guides without taking control away from the user.
The production risk is novelty fatigue. Pointer-tracking demos are fun for five seconds and annoying forever if they cover content, slow input, or keep running on touch devices. The effect should be short, optional, and easy to remove.
import CursorMove from '@/components/effects/cursor-move' const page = () => { return ( <> <CursorMove text="Hello!" backgroundClassName="bg-zinc-950" /> </> )} export default pageA creative developer portfolio can use Cursor Move in a short hero interaction where coordinates and text distortion introduce the site’s personality. The outcome is responsiveness: the visitor feels the page react before they scroll into the work.
Not for product flows, forms, dashboards, checkout, mobile-first pages, or any screen where pointer movement would distract from task completion.
Not for long pages where the effect follows the visitor forever.
Throttle pointer updates with requestAnimationFrame, avoid updating React state on every raw mouse event where unnecessary, and clean up listeners on route change.
Disable on coarse pointers and keep native touch behavior. Do not expose rapidly changing coordinates to assistive technology unless they are essential, which they usually are not. Cursor Move has no reduced-motion mode: on desktop the letters keep bending and the coordinates keep tracking the cursor.
| Prop | Type | Default | Description |
|---|---|---|---|
text | string | hello! | Text affected by cursor movement. |
textColor | color | #f97316 | Color of the cursor-reactive text. |
showCrosshair | boolean | true | Shows the cursor-following crosshair. |
crosshairVariant | string | solid | Crosshair line style. Needs Show Crosshair on. |
showCursorDot | boolean | true | Shows the small cursor dot. |
crosshairColor | color | #ffffff | Crosshair line color (drawn at 20% strength). Needs Show Crosshair on. |
cursorDotColor | color | #f97316 | Color of the small cursor dot. Needs Show Cursor Dot on. |
lerp | number | 0.2 | Mouse-follow smoothing amount; lower values feel smoother and slower, higher values track faster. |
showCoordinates | boolean | true | Shows the live x/y coordinate readout. |
Use it when pointer position itself is part of a short creative or technical interaction.
Usually no. Keep it scoped to a hero, demo, or controlled section so it does not become background noise.
Coordinates can be visual decoration, but they should not be announced continuously or required to understand the page.
Disable the cursor-specific behavior and show a static section or tap-safe alternative.
Cursor Move has no reduced-motion mode. The text bending and coordinate tracking are the interaction itself, so they keep running on desktop; below 1025px or on coarse pointers the tracking is already off.
Yes. A custom version should define pointer behavior, text response, coordinate treatment, motion boundaries, fallback behavior, source handoff, and implementation notes.
Need a custom effect? Tell us what to create.