kmp-loading-animations
2.0.5indexedReady-to-use animated loading/spinner indicators with extensive customization, a linked catalog for lookup/random selection, and a showcase grid featuring 30+ styles.
1
Stars
—
Used by
dependents
—
Health
/ 100
KMP Loading Animation
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.
Demo
Installation
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.
Step 1 — Use any indicator
@Composable
fun Greeting() {
PacmanIndicator()
}
Every indicator exposes optional parameters for full customisation:
PacmanIndicator(
color = Color.Black,
ballDiameter = 60f,
canvasSize = 60.dp,
animationDuration = 1000
)
Available Indicators
Additional indicators: GridFadeDiagonal, GridFadeAntiDiagonal,
BallRespectivelyExitIndicator, TriangleShapeIndicator,
CircleShapeIndicator.
Catalog API
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
Get all indicators with default settings
val catalog = indicatorsCatalog() // white, 40.dp
Custom color and size
val catalog = indicatorsCatalog(
color = Color.Cyan,
sizeDp = 60.dp
)
Pick a specific indicator by type
@Composable
fun MyScreen() {
// Direct map access — no searching required
indicatorsCatalog()[IndicatorType.PACMAN]?.invoke()
}
Show a random loading indicator
@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)
}
}
Iterate over all indicators
@Composable
fun ListAll() {
val catalog = indicatorsCatalog()
catalog.forEach { (type, indicator) ->
Row {
indicator()
Text(type.displayName)
}
}
}
Display the full showcase grid
@Composable
fun App() {
LoadingShowcase() // adaptive grid with labels
}
Available IndicatorType values
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
Targets
| Platform | Status |
|---|---|
| Android | ✅ |
License
Copyright 2023 Mahboubeh Seyedpour
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance the License.
You may obtain a copy of the License at
http:
Unless applicable law agreed to writing, software
distributed under the License distributed an BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express implied.
See the License the specific language governing permissions
limitations under the License.