# AnimateDigits

> A number whose digits spring in and out as it changes (motion), direction following the change.

## Facts

- **Product**: Max
- **Family**: Data display
- **Global**: `window.DigitalCrew.AnimateDigits`
- **Source**: `max-agent: src/components/ui/animate-digits.tsx`
- **Import in the app**: `import { AnimateDigits } from "@/components/ui/animate-digits";`
- **Live preview**: /design/components/animate-digits/preview.html
- **Page**: /design/components/animate-digits

## Guidelines

**Use it for** live counters the user is watching change — a focus session's count, credits ticking down. Static figures stay static.

**What you provide**: `value` as a formatted string ("1,284"), the type through `className` (`text-4xl font-semibold tabular-nums tracking-tight`), and optional spring tuning (`enterStiffness`, `enterDamping`, `enterY`, `enterBlur`). It respects reduced motion.

## API

```ts
export interface AnimateDigitsProps {
    value: string;
    gap?: number;
    className?: string;
    digitClassName?: string;
    enterStiffness?: number;
    enterDamping?: number;
    exitStiffness?: number;
    exitDamping?: number;
    direction?: "dynamic" | "up" | "down";
    enterY?: number;
    enterBlur?: number;
    enterScale?: number;
    animationDelay?: number;
}
export declare function AnimateDigits({ value, gap, className, digitClassName, enterStiffness, enterDamping, exitStiffness, exitDamping, direction, enterY, enterBlur, enterScale, animationDelay, }: AnimateDigitsProps): JSX.Element;
export default AnimateDigits;
```

## Example

```html
<div id="root" class="p-6"></div>
<script>
(function () {
  var h = React.createElement, DC = window.DigitalCrew, I = DC.Icons;
function App() {
  var s = React.useState(1284);
  return h("div", { className: "flex items-center gap-6" },
    h("div", { className: "grid gap-1" },
      h("span", { className: "text-xs text-muted-foreground" }, "Replies this month"),
      h(DC.AnimateDigits, { value: s[0].toLocaleString("en-US"), className: "text-4xl font-semibold tabular-nums tracking-tight" })),
    h(DC.Button, { variant: "outline", onClick: function () { s[1](s[0] + 7); } }, h(I.Plus), "Add 7"));
}
  ReactDOM.createRoot(document.getElementById("root")).render(h(DC.TooltipProvider, { delayDuration: 80 }, h(App)));
})();
</script>
```

## More in Data display

- [AgentFace](/design/components/agent-face.md): A Digital Worker's face: its approved portrait, or its initials on its accent tile.
- [Avatar](/design/components/avatar.md): A round image with an initials fallback (Radix Avatar), 32px by default.
- [CampaignStatusBadge](/design/components/campaign-status-badge.md): The campaign lifecycle pill: Draft, Active, Paused, Stopped, Completed, Archived.
- [ChannelBadge](/design/components/channel-badge.md): Marks which channel a conversation or step runs on: email (amber), LinkedIn (sky), WhatsApp (emerald).
- [EmailVerificationBadge](/design/components/email-verification-badge.md): The deliverability verdict for an email address, with an icon and an optional score.
- [HeroMetric](/design/components/hero-metric.md): One big number with its previous-period comparison, a trend pill and a pacing bar.
- [KpiCard](/design/components/kpi-card.md): A KPI tile — label, value, trend — and `KpiSection`, the glass panel that groups them.
- [MaxIconSet](/design/components/max-icon-set.md): Max's own SVG icons, exported as `DC.MaxIcons`: integration and channel logos, message delivery states, and the appearance-picker tiles.
- [MetricTile](/design/components/metric-tile.md): A compact glass tile for a scored metric: label, value toned by score band, hint.
- [ProspectAvatar](/design/components/prospect-avatar.md): A prospect's photo, or a gradient disc hashed from their name, with an optional unread halo.
- [Snippet](/design/components/snippet.md): A monospace command block with a copy button whose icon turns into a check after copying.
- [TimeLens](/design/components/time-lens.md): Max's agenda: hour marks, ticks and tasks in one scrolling column, read through a fixed lens that shows the time under it.
- [WorldGlobe](/design/components/world-globe.md): An interactive d3-geo globe on canvas with avatar markers that merge into heat-coloured count bubbles.