A collection of beautiful, ready-to-use loading & spinner animations for Compose Multiplatform — Android, iOS, Desktop (JVM), and Web.

Adapted from the famous AVLoadingIndicatorView and rebuilt from the ground up with Kotlin Multiplatform + Compose.

Add the dependency to your commonMain source set:

// build.gradle.kts
kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation("io.github.akimaleo:kmp-loading-animation:2.0.5")
        }
    }
}

That's it! Works on all platforms: Android, iOS, Desktop, JS, and WasmJS.

@Composable
fun Greeting() {
    PacmanIndicator()
}

Every indicator exposes optional parameters for full customisation:

PacmanIndicator(
    color = Color.Black,
    ballDiameter = 60f,
    canvasSize = 60.dp,
    animationDuration = 1000
)

Additional indicators: GridFadeDiagonal, GridFadeAntiDiagonal, BallRespectivelyExitIndicator, TriangleShapeIndicator, CircleShapeIndicator.

The indicatorsCatalog() function returns a Map<IndicatorType, @Composable () -> Unit> — a linked map that preserves insertion order. Use it to look up a specific indicator by key, iterate over all entries, or pick one at random.

import com.kawa.loading.kmp.indicatorsCatalog
import com.kawa.loading.kmp.enums.IndicatorType

val catalog = indicatorsCatalog()          // white, 40.dp

val catalog = indicatorsCatalog(
    color = Color.Cyan,
    sizeDp = 60.dp
)

@Composable
fun MyScreen() {
    // Direct map access — no searching required
    indicatorsCatalog()[IndicatorType.PACMAN]?.invoke()
}

@Composable
fun RandomLoader() {
    val catalog = remember { indicatorsCatalog(color = Color.White) }
    val (type, indicator) = remember { catalog.entries.random() }

    Column(horizontalAlignment = Alignment.CenterHorizontally) {
        indicator()
        Text(type.displayName)
    }
}

@Composable
fun ListAll() {
    val catalog = indicatorsCatalog()
    catalog.forEach { (type, indicator) ->
        Row {
            indicator()
            Text(type.displayName)
        }
    }
}

@Composable
fun App() {
    LoadingShowcase()   // adaptive grid with labels
}

PULSATING_DOT, GRID_PULSATING, CIRCULAR_PULSATING,
BALL_CLIP_ROTATE_PULSE, SQUARE_SPIN, BALL_CLIP_ROTATE_MULTIPLE,
BALL_PULSE_RISE, BALL_ROTATE, CUBE_TRANSITION,
BALL_ZIG_ZAG, BALL_ZIG_ZAG_DEFLECT, BALL_TRIANGLE_PATH,
BALL_SCALE, LINE_SCALE_ACCORDION, LINE_SCALE_RANDOM,
BALL_SCALE_MULTIPLE, BALL_PULSE_SYNC, BALL_BEAT,
LINE_SCALE_SYMMETRIC, LINE_SCALE_PULSE_OUT,
BALL_SCALE_RIPPLE, BALL_SCALE_RIPPLE_MULTIPLE,
BALL_SPIN_FADE_LOADER, LINE_SPIN_FADE_LOADER,
TRIANGLE_SPIN, PACMAN, GRID_BEAT, SEMI_CIRCLE_SPIN

Copyright 2023 Mahboubeh Seyedpour

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.