Sand Timer, animated React component

A session timer drawn as a real hourglass: every grain is simulated on a canvas, piling, sliding and funneling through the neck at exactly the rate the time runs out. Pressing the button turns the glass over.

Pro
Loaders
Spring

Play with it

Move the controls and watch it change. Copy code gives you a snippet with only the props you changed.

Session ends in0:30

Props

Prop	Type	Default	What it does
seconds	number	30	How long a full glass takes to run out, in seconds. The readout counts down from the same value.
autoplay	boolean	false	Turns the glass over by itself when the top is nearly empty, until someone presses the button.

Add it to your project

Prepare your project

You need Tailwind CSS and the @/import alias. If shadcn isn't set up yet, initialise it once:

npx shadcn@latest init

Then add the Nexus registry to your components.json (the registries key is the part that matters):

{
  "$schema": "https://ui.shadcn.com/schema.json",
  "style": "default",
  "rsc": true,
  "tsx": true,
  "tailwind": {
    "css": "src/app/globals.css",
    "baseColor": "neutral",
    "cssVariables": true,
    "prefix": ""
  },
  "aliases": {
    "components": "@/components",
    "utils": "@/lib/utils",
    "ui": "@/components/ui",
    "lib": "@/lib",
    "hooks": "@/hooks"
  },
  "registries": {
    "@nexus-labs": "https://www.nexus-ui.com/api/registry/{name}"
  }
}

2
Add the component
Run this from your project root. It adds the component, the utilities it uses and its packages.
```
npx shadcn@latest add @nexus-labs/sand-timer
```
3
Check what was added
With the standard aliases, these files land in your project:
components/
sand-timer/
index.ts
sand-timer.tsx
4
Copying by hand? Install the packages
Skip this if you used the command above.
```
npm install framer-motion
```

Use it in a page

Import it and render it. The Code tab above has the full example.

// app/page.tsx
import { SandTimer } from "@/components/sand-timer";

export default function Page() {
  return (
    <main>
      <SandTimer />
    </main>
  );
}

Sand Timer, animated React component

Play with it

Props

More loaders