Skip to content
jezuiMake it yours
← Components

Animated Counter

Count toward a target the first time it enters view.

Open ↗

Make it yours.

Install the editable source and its dependencies into your React + Tailwind project.

Scroll horizontally for long lines
pnpm dlx shadcn@4.0.8 add http://localhost:3000/r/animated-counter.json

Use it

Scroll horizontally for long lines
"use client";
import {AnimatedCounter} from '@/components/jez-ui/ui/animated-counter';

export default function Example(){

return <><div className="w-full rounded-xl bg-accent p-9 text-foreground md:p-14"><AnimatedCounter target={2048} className="font-display text-7xl tracking-tight md:text-8xl"/><h3 className="mt-6 text-2xl">Small steps. Real progress.</h3><p className="mt-2 text-sm">Counts into view, once you're here.</p></div></>;
}

Props & types

Scroll horizontally for long lines
{
  target: number;
  duration?: number;
  className?: string;
}

Source

View 2 source files

registry/ui/animated-counter.tsx

Scroll horizontally for long lines
"use client";
import * as React from "react";
import { cn } from "./utils";
import { animate, useInView, useReducedMotion } from "motion/react";
export function AnimatedCounter({
  target,
  duration = 1.4,
  className,
}: {
  target: number;
  duration?: number;
  className?: string;
}) {
  const ref = React.useRef<HTMLSpanElement>(null);
  const visible = useInView(ref, { once: true });
  const reduce = useReducedMotion();
  const [value, setValue] = React.useState(0);
  React.useEffect(() => {
    if (!visible) return;
    const animation = animate(0, target, {
      duration: reduce ? 0 : duration,
      onUpdate: (v) => setValue(Math.round(v)),
    });
    return () => animation.stop();
  }, [visible, target, duration, reduce]);
  return (
    <span
      ref={ref}
      className={cn("tabular-nums", className)}
      aria-label={String(target)}
    >
      <span aria-hidden="true">{value.toLocaleString()}</span>
    </span>
  );
}

registry/ui/utils.ts

Scroll horizontally for long lines
import { clsx, type ClassValue } from "clsx";
import { twMerge } from "tailwind-merge";
export function cn(...values: ClassValue[]) {
  return twMerge(clsx(values));
}

Dependencies

motion@13.2.0 · clsx@2.1.1 · tailwind-merge@3.5.0

Accessibility & behaviour

Respect reduced-motion preferences. Decorative effects must not carry essential information. WebGL scenes include a static fallback and only render while visible.

Read the accessibility and performance guide →