Real-Time Cursors, animated React component
A shared design board with teammates' cursors moving over it live: arrows glide between spots and lean with their speed, name tags trail behind and swing when they stop, stops land as clicks and now and then someone drops a comment. Your own pointer gets a You tag when it comes over the board.
- Free
- Motion Effects
- Spring
- Hover
Like Real-Time Cursors? 256 more are in Pro.
Pro unlocks all 256 Pro components, every template and block, and everything we release next. Real-Time Cursors stays free.
Play with it
Move the controls and watch it change. Copy code gives you a snippet with only the props you changed.
Launch board
4 here now
Move your pointer over the board to join in.
Props
| Prop | Type | Default | What it does |
|---|---|---|---|
| cursors | LiveCursor[] | 3 teammates | Teammates: { name, color, textColor?, path: {x, y}[] in % of the board, duration?, delay?, note? }. |
| title | string | "Launch board" | Board name in the header. |
| showYou | boolean | true | Shows a You tag that follows the visitor's pointer over the board. |
| youColor | string | "#30d158" | Colour of the visitor's tag. |
| autoplay | boolean | false | Moves a demo You cursor round the board until the visitor's pointer comes over it. |
| className | string | — | Extra classes for the card. |
Add it to your project
- 1
Set up your project once
You need a Next.js project with Tailwind CSS and the
@/import alias. In its root folder, run this once. It createscomponents.jsonand thecn()helper insrc/lib/utils.ts:npx shadcn@latest init -d
Starting from nothing? The Quick Start walks through the whole thing.
- 2
Connect the registry
Run this once per project. It writes the Nexus UI entry into
components.jsonfor you:npx shadcn@latest registry add "@nexus-labs=https://www.nexus-ui.com/api/registry/{name}"Type it exactly as shown.
{name}is filled in by the CLI with the component you ask for, so you never replace it.
- 3
Add the component
Run this from your project root. It adds the component, the helpers it imports and its npm packages.
npx shadcn@latest add @nexus-labs/real-time-cursors
- 4
Check what was added
With a project made as in the Quick Start (a
src/folder), these files land in it:components/real-time-cursors/index.tsreal-time-cursors.tsx - 5
Copying by hand? Skip the registry
Instead of steps 2 and 3 you can copy the files yourself, with no registry and no API key. Step 1 still applies, so that
cn()exists. Install the packages:npm install framer-motion
Then show the source and create each file at the path it gives:
- 6
Use it in a page
Installing only adds the files. Import the component in a page and render it. The Usage tab on the preview shows a fuller example with props:
// src/app/page.tsx import { RealTimeCursors } from "@/components/real-time-cursors"; export default function Page() { return ( <main> <RealTimeCursors /> </main> ); }
Like Real-Time Cursors? 256 more are in Pro.
Pro unlocks all 256 Pro components, every template and block, and everything we release next. Real-Time Cursors stays free.
About Real-Time Cursors
Real-Time Cursors renders multiple named, color-coded cursors moving simultaneously across the page with spring-smoothed motion. Each cursor label and color is individually configurable. The component is designed for demonstrating real-time collaboration features — multiplayer cursors, shared whiteboards, live document editing — without backend infrastructure, making it suitable for feature screenshots, product demos, and marketing landing pages.
Good for
- Collaboration tool feature demos
- Multiplayer product showcases
- Live editing feature illustrations
- SaaS marketing page interactive sections