Number Ticker

Animate numbers to count up or down to a target number

Installation

Copy and paste the following code into your project.

"use client"
 
import { useEffect, useRef } from "react"
import { useInView, useMotionValue, useSpring } from "framer-motion"
 
import { cn } from "@/lib/utils"
 
export function NumberTicker({
  value,
  direction = "up",
  delay = 0,
  className,
}: {
  value: number
  direction?: "up" | "down"
  className?: string
  delay?: number // delay in s
}) {
  const ref = useRef<HTMLSpanElement>(null)
  const motionValue = useMotionValue(direction === "down" ? value : 0)
  const springValue = useSpring(motionValue, {
    damping: 60,
    stiffness: 100,
  })
  const isInView = useInView(ref, { once: true, margin: "0px" })
 
  useEffect(() => {
    isInView &&
      setTimeout(() => {
        motionValue.set(direction === "down" ? 0 : value)
      }, delay * 1000)
  }, [motionValue, isInView, delay, value, direction])
 
  useEffect(
    () =>
      springValue.on("change", (latest) => {
        if (ref.current) {
          ref.current.textContent = Intl.NumberFormat("en-US").format(
            Number(latest.toFixed(0))
          )
        }
      }),
    [springValue]
  )
 
  return (
    <span
      className={cn(
        "inline-block tabular-nums text-black dark:text-white tracking-wider",
        className
      )}
      ref={ref}
    />
  )
}

Update the import paths to match your project setup.

Props

PropTypeDescriptionDefault
valueintThe value to count to0
directionup | downThe direction to count inup