RollingNumbers is a Kotlin Multiplatform Compose library that animates text changes by rolling individual characters vertically — just like a odometer, an old school cash register, or those nostalgic airport split-flap boards.

Whether you’re showing stock prices, countdowns, money, or even flight numbers, RollingNumbers makes every change feel satisfyingly alive with Levenshtein distance effect! It also comes with a separate ready-to-use CurrencyRollingNumbers for beautifully animated, locale-friendly money displays.

• 🔢 Animate anything — numbers, letters, symbols, emojis… if it’s a character, it can roll.
• 💰 Built-in currency mode — grouping separators, decimal points, and currency symbol placement (front or back) out of the box.
• ↕️ Smart direction detection — rolls up when values go up, down when they drop.
• 🎯 Custom character sets — hex digits, flight numbers, scoreboard letters… your animation path, your rules.
• 🎨 Fully styleable — integrates seamlessly with Compose’s TextStyle.
• ⚡ Adjustable speed — from dramatic slow rolls to rapid-fire flicks.
• 🪶 Lightweight & clean — minimal dependencies, easy to drop into any project.
• 🌍 KMP ready — works across Android, iOS, Desktop and WASM.
• 🧠 Levenshtein-powered animation — calculates the smoothest, shortest scroll path between states.
• ♿ Accessible — screen readers announce the full target value as a single unit, no per-character noise.

1. Inspired by Robinhood Ticker library — but built for the modern Kotlin Multiplatform Compose world.
2. Fully Kotlin Multiplatform — the same rolling goodness on Android, iOS and Desktop.
3. Comes with two ready-made components:
   • RollingNumbers for any kind of text
   • CurrencyRollingNumbers for perfectly formatted animated amounts with currency.
4. Supports alphanumeric and custom sets — perfect for flight numbers, scoreboard codes, or creative displays.
5. Optimized for performance while still feeling smooth and fun to watch.

Add the dependency in your build.gradle.kts:

Add the mavenCentral repository to your settings.gradle.kts file:

dependencyResolutionManagement {
    repositories {
        mavenCentral()
    }
}

Add the dependency:

dependencies {
    implementation "com.dontsaybojio:rollingnumbers:X.X.X"
}

RollingNumbers(
    text = amount,
    characterLists = listOf(Utils.provideNumberString()),
    animationDuration = DefaultAnimationDuration.Default.duration,
)

CurrencyRollingNumbers(
    amount = amount,
    characterLists = listOf(Utils.provideNumberString()),
    animationDuration = DefaultAnimationDuration.Default.duration,
)

RollingNumbers(
    text = text,
    characterLists = Utils.provideAlphanumericList(),
    animationDuration = DefaultAnimationDuration.Slow.duration,
)

The library uses: • Levenshtein distance to determine minimal scrolling changes between the current and target text. • AnimatedCharacterColumn for per-character scroll animation. • clipToBounds() to keep animations inside their columns.

• Multiple Character Sets: You can pass multiple strings in characterLists if you want certain characters to scroll independently (e.g., digits and symbols in different sequences).

• Custom Direction Control: For number-based animations, use ScrollingDirection.Up or ScrollingDirection.Down to force a scroll direction or it can be ScrollingDirection.Any for the nearest distance.

• Accessibility: Both RollingNumbers and CurrencyRollingNumbers use clearAndSetSemantics to expose a single contentDescription to screen readers. This ensures the complete target value is announced as one coherent unit, rather than individual animated characters being read separately.

Pull requests are welcome! If you find a bug or have a feature request, please open an issue on GitHub.

• Robinhood Ticker