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.

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.

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

• Robinhood Ticker