# Carry Count
URL: https://remocn.dev/docs/numbers/carry-count

A big counter reaches 13,580 with a small caption, "scenes students built in week one"

- Install: `npx shadcn@latest add @remocn/carry-count`
- Vibe: data
- Natural length: 120f @ 30fps

## Installation

```bash
npx shadcn@latest add @remocn/carry-count
```

## Usage

```tsx
// src/Root.tsx
import { Composition } from "remotion";
import { CarryCount } from "@/components/remocn/carry-count";

const CarryCountScene = () => (
  <CarryCount
    from={2855}
    value={13580}
    label={"scenes students\nbuilt in week one"}
  />
);

export const RemotionRoot = () => (
  <Composition
    id="CarryCount"
    component={CarryCountScene}
    durationInFrames={150}
    fps={30}
    width={1280}
    height={720}
  />
);
```

A large number starts at `from` and adds in `steps` chunks. Each change squashes the changed digit and, where a column overflows, a small disc carries a 1 over to the next column, growing a new digit at the left when needed. A caption of one or more lines slides up beside the number. Pass `value`, `from`, `steps` and `label` with a line break. It ships light and dark through the `theme` prop.

## Props

| Prop | Type | Default | Description |
|---|---|---|---|
| `value` | `number` | `13580` | The final number the count lands on. |
| `from` | `number` | `2855` | The number the count starts from. |
| `steps` | `number` | `5` | How many additions it takes to get from `from` to `value`. |
| `label` | `string` | `"scenes students\nbuilt in week one"` | Caption beside or below the number; use a line break to split lines. |
| `accent` | `string` | — | Colour of the carry disc. |
| `background` | `string` | — | Stage colour; pass 'transparent' to layer over other footage. |
| `speed` | `number` | `1` | Playback speed multiplier; 1 is the designed pace. |
| `theme` | `"dark" \| "light"` | `"dark"` | Ships light and dark. |

## Use when
- A usage-stat beat where a number climbs in chunks and a small disc visibly carries a 1 into the next column.
- A growth claim such as 13,580 scenes built that should feel mechanical and satisfying, like a tally rolling over.
- A caption-beside-number layout that works in both landscape and portrait.

## Don't use when
- You want digits that roll continuously like a live feed — use `live-ticker`.
- You want rods and beads instead of carry discs — use `abacus-count`.
- You want the count to land on beats of music — use `beat-count`.