Morphing blobs for Compose Multiplatform on Android, iOS and Web.

API docs · How the math works, an interactive explainer that runs in the browser

Few segments, solid	More segments, outlined
Multiple layers	Multiple layers with blur

A Blob is a stack of layers drawn around any Shape. Each layer pushes the outline in and out along its normal and has its own settings:

A layer with amplitude = 0.dp..0.dp is the plain shape: use one on top as a solid, still body.

commonMain.dependencies {
    implementation("io.github.piotrprus:kblobs:0.2.0")
}

Blob(
    layers = BlobPresets.aura(body = Color(0xFFD3B26E)),
    modifier = Modifier.size(160.dp),
)

Custom layers, around any shape, following a live level:

Blob(
    layers = listOf(
        BlobLayer(color = Color(0xFF4DABF7), alpha = 0.3f, segments = 5, amplitude = (-4).dp..18.dp, blur = 8.dp),
        BlobLayer(color = Color(0xFFDA77F2), alpha = 0.4f, segments = 12, amplitude = (-3).dp..8.dp, rotation = 40f, spin = 15f),
        BlobLayer(color = Color.White, amplitude = 0.dp..0.dp),
    ),
    shape = RoundedCornerShape(32.dp),
    intensity = { micLevel },   // read each frame, no recomposition
    speed = { 1f + micLevel },  // changes stay smooth: time is integrated, not rescaled
    modifier = Modifier.size(160.dp),
)

The shape fills the composable's bounds. Layers that move outward draw outside them, like a shadow, so leave room around the blob.

intensity scales each layer's swing around the middle of its amplitude range: 0 holds the layer still at the midpoint, 1 uses the full range. animate = false stops the motion, for reduced motion.

Any Shape works: CircleShape, RoundedCornerShape, a GenericShape, or a Material 3 MaterialShapes.*.toShape(). Only the first contour of the outline is used.

samples/ has an Android and an iOS app. Add layers with +, open a layer with its chevron, and change its color, alpha, segments, amplitude, tempo, rotation, spin, blur, blend mode and thickness live, or switch a layer off. samples/web is the browser explainer linked above.

./gradlew :samples:androidApp:installDebug
open samples/iosApp/iosApp.xcodeproj
./gradlew :samples:web:wasmJsBrowserDevelopmentRun

Apache 2.0